WebBrowser

クラス階層

• System.ComponentModel.Component
  • System.Windows.Forms.Control
    • System.Windows.Forms.WebBrowserBase
      • System.Windows.Forms.WebBrowser

プロパティ

次の2つのプロパティは、既定値のtrueからfalseに変更しようとするとErrorCode -2147467259 (0x80004005:Unspecified failure) で、COMException例外が発生することがあります。

• AllowWebBrowserDrop
• ScrollBarsEnabled

その場合にはこれらのプロパティは、コントロールが表示されてからDocumentCompletedが発生する前に設定します。WebBrowser Control creates COM Exception

Document

Webページの要素にアクセスできます。WebBrowser.Document プロパティ (System.Windows.Forms) | MSDN

HtmlDocument document = webBrowser.Document; // null

webBrowser.DocumentCompleted += delegate
{
    document = webBrowser.Document; // "System.Windows.Forms.HtmlDocument"
};

webBrowser.Navigate("about:blank");

DocumentText

ドキュメントのコンテンツを表す文字列です。このプロパティに文字列を設定すると、それが適用される前にabout:blankが自動的に読み込まれます。そしてそのとき、

• Navigating
• Navigated
• DocumentCompleted

の各イベントが発生します。解説 - WebBrowser.DocumentText プロパティ (System.Windows.Forms) | MSDN

メソッド

Navigate

AllowNavigationがfalseに設定されていると、初回以外のURLの指定は無視されます。

このメソッドをWebBrowserBase.OnHandleCreated()内で呼び出すと、COMException「エラー HRESULT E_FAIL が COM コンポーネントの呼び出しから返されました。」ErrorCode=-2147467259 (0x80004005) が発生します。

イベント

これらはWebBrowserコントロールのイベントであり、DOMのイベントはAttachEventHandler()で捕捉できます。

新しいドキュメントへ移動するときは、

1. Navigating
2. Navigated
3. ProgressChanged
4. DocumentCompleted

の順でイベントが発生します。

NewWindow

新しいウィンドウが開く前に発生します。

public event CancelEventHandler NewWindow

新規ウィンドウのURLの取得

• webBrowserで別のウィンドウで開くときの開く先のURLの取得法 - Visual C# - Visual Studio User Group (2007/03/01)
• VB2005のWebBrowserコントロールにNewWindow2イベントを拡張する | VisualBasicサンプルプログラム

≫NewWindow2イベント

DocumentCompleted

ドキュメントの読み込みが完了した後に発生します。

public event WebBrowserDocumentCompletedEventHandler DocumentCompleted

ページ内にframeがあると、DocumentCompletedイベントはそのframeごとに発生します。よって全体の読み込みが完了したことは別に判定する必要があり、それには読み込まれたURL (e.Url) と現在のページのURL (((WebBrowser)sender).Url) が等しいことを確認します。

private void webBrowser_DocumentCompleted(object sender, WebBrowserDocumentCompletedEventArgs e)
{
    if (e.Url == ((WebBrowser)sender).Url)
    {
    }
}

コンテンツの作成

外部のリソースを読み込むのではなく、HTMLでコンテンツを作成する方法を考えます。

HTMLからコンテンツを作成した場合、ドキュメントのURLは"about:blank"となり、他のリソースへは相対パスでアクセスできません。

HTMLコードで作成

HTMLコードを文字列で記述します。それにはDocumentTextプロパティに設定するか、Document.Write()メソッドを呼び出します。

webBrowser.DocumentText = "<B>ABC</B>";

DocumentTextへの設定は、DocumentCompletedイベントの発生まで適用されません。

DOMで作成

DocumentプロパティからHtmlDocumentを取得したら、後はJavaScriptでDOMを処理するのと同じ要領で作成できます。

WebBrowserDocumentCompletedEventHandler handler = null;
handler = delegate
{
    webBrowser.DocumentCompleted -= handler;

    HtmlDocument document = webBrowser.Document;

    HtmlElement element = document.CreateElement("b");
    element.SetAttribute("title", "foo");
    element.InnerText = "ABC";

    document.Body.AppendChild(element);
};
webBrowser.DocumentCompleted += handler;
webBrowser.Navigate("about:blank");

ただしHtmlDocumentにはcreateTextNode()がないため、テキストノードを直接作成できません。よってその必要があるならばIHTMLDocument3オブジェクトを取得し、それのcreateTextNode()を用います。

HtmlDocument document = webBrowser.Document;
mshtml.IHTMLDocument2 htmlDocument2 = (mshtml.IHTMLDocument2)document.DomDocument;
mshtml.IHTMLDocument3 htmlDocument3 = (mshtml.IHTMLDocument3)document.DomDocument;

mshtml.IHTMLDOMNode body = (mshtml.IHTMLDOMNode)htmlDocument2.body;

mshtml.IHTMLElement element = htmlDocument2.createElement("b"); // 要素の作成
element.innerText = "ABC";
body.appendChild((mshtml.IHTMLDOMNode)element);

mshtml.IHTMLDOMNode text = htmlDocument3.createTextNode("DEF"); // テキストノードの作成
body.appendChild(text);

string html = document.Body.InnerHtml; // "<B>ABC</B>DEF"

または単純に、InnerHtmlまたはInnerTextに文字列を設定しても同じです。

webBrowser.Document.Body.InnerHtml = "<B>ABC</B>DEF";

mshtml名前空間のクラスを利用するには、Microsoft.mshtmlを参照に追加します。

createTextNode()

IHTMLDOMNode retVal = object.createTextNode(text);

イベント ハンドラの追加

public void AttachEventHandler(
    string eventName,         // 捕捉するイベントの名前
    EventHandler eventHandler // イベントを捕捉するマネージド コード
)

AttachEventHandlerによるハンドラの追加は、DocumentCompletedイベントの発生を待ってから行います。

senderの特定

たとえばclickイベントは、次のようにAttachEventHandler()で捕捉できます。

{
    HtmlDocument document = webBrowser.Document;
    HtmlElement element = document.CreateElement("button");
    element.SetAttribute("value", "Click me");

    element.AttachEventHandler("onclick", new EventHandler(Element_Click));
}

private void Element_Click(object sender, EventArgs e)
{
    // senderはnull
}

ただしこの方法ではハンドラ内でsenderを特定できないため、その情報が必要ならばHtmlElement.Clickイベントを用います。

    // (省略)
    element.Click += new HtmlElementEventHandler(Element_Click);
}

private void Element_Click(object sender, HtmlElementEventArgs e)
{
    HtmlElement element = (HtmlElement)sender;
}

しかしHtmlElementにそのイベントが用意されていなければこの方法は適用できないため、より汎用的には匿名メソッドを用いて、そのメソッド内からelementのインスタンスをsenderとして渡します。AttachEventHandler fires with sender==null and empty EventArgs, so how to get the value of a SELECT element?

    // (省略)
    element.AttachEventHandler("onclick", delegate
    {
        Element_Click(element, EventArgs.Empty);
    });
}

private void Element_Click(HtmlElement element, EventArgs e)
{
}

イベントの発生

指定要素でイベントを発生させ、それに登録されているイベント ハンドラを呼び出せます。

public void RaiseEvent(
    string eventName
)

elememt.RaiseEvent("onclick");

同様の処理は、InvokeMember()ならば次のように記述します。HtmlElement.InvokeMember メソッド (String) (System.Windows.Forms) | MSDN

elememt.InvokeMember("click");

イベント ハンドラの削除

AttachEventHandler()で取り付けたハンドラは、DetachEventHandlerで取り外せます。

public void DetachEventHandler (
    string eventName,
    EventHandler eventHandler
);

element.AttachEventHandler("onclick", Element_Click); // ハンドラの登録

// ...

element.DetachEventHandler("onclick", Element_Click); // ハンドラの削除

トラブル対処法

デバッグ時にハングアップする

次の3条件が満たされるとき、WebBrowserが含まれるコントロールが表示されるときにアプリケーションがハングアップします。

• デバッグのオプションで、[マネージ互換モードの使用]が有効
• プロジェクトのプロパティで、[ネイティブ コードのデバッグを有効にする]が有効
• プロジェクトのプラットフォームがx86

よってデバッグの設定を修正します。

MSHTMLを読み込めない

Microsoft HTML Object Library (Microsoft.mshtml) を参照しているとき、「warning MSB3283: タイプ ライブラリ "MSHTML" のラッパー アセンブリが見つかりません。(warning MSB3283: Cannot find wrapper assembly for type library "MSHTML".)」として、そのアセンブリの読み込みに失敗することがあります。そのときにはまず、参照しているファイル%WINDIR%\assembly\GAC\Microsoft.mshtml\7.0.3300.0__b03f5f7f11d50a3a\Microsoft.mshtml.dllを確認し、それが誤っているならば修正します。

解決方法1：Visual Studioを更新する

適用できる更新があるならばそれを実行することで、解決されることがあります。

解決方法2：アセンブリを登録し直す

アセンブリ登録ツール (RegAsm) で、Microsoft.mshtml.dllを登録し直します。Fixing 'Cannot find wrapper assembly for type library "MSHTML"' After Windows 10 Upgrade

MSHTMLを読み込めるようになった後に「参照コンポーネント MSHTML には、更新された使用可能なカスタム ラッパーがあります。(There are updated custom wrappers available for the following referenved components: Mshtml)」と警告されることがありますが、これはVisual Studioを再起動することで解決できます。

解決方法3：プライマリ相互運用アセンブリ (Primary Interop Assemblies : PIA) を利用する

参照するアセンブリを、参照マネージャーの【アセンブリ → 拡張】にあるMicrosoft.mshtmlに変更します。この実体は%PROGRAMFILES(X86)%\Microsoft.NET\Primary Interop Assemblies\Microsoft.mshtml.dllにあります。プライマリ相互運用アセンブリ (PIA) | MSDN

• 導入
  • C#のバージョン
• 文法
  • データ型
    • 数値型
    • 配列
      • コレクション
    • ポインタ
    • 文字列
  • 演算子
• クラス
  • メソッド
  • プロパティ
• インターフェイス
• ジェネリック
• デリゲート
  • イベント
• 属性
• コントロール
  • Controlクラス
  • Formクラス
• グラフィック
• 音声と動画
  • 音声
  • 動画
• リソース
• プロセス
• スレッド
• ネットワーク
• ストリーム
  • ファイル
• LINQ
  • Enumerableクラス
• データ永続化
  • データベース
• 国際化
• ツール
  • ビルド システム
  • コンパイラ
• テスト
• デバッグ
• 配置
  • アプリケーション設定
• C++との相互運用
  • DLL関数の呼び出し
• トラブル対処法

• お問い合わせ
• プライバシーポリシー
• サイトマップ