.NET TIPS WebBrowserコントロールのコンテンツを文字列により設定するには？［2.0、C#、VB］ デジタルアドバンテージ　遠藤 孝信 2008/08/07

　Windowsフォーム用のWebBrowserコントロール（.NET Framework 2.0以降で利用可能）では、UriプロパティにURLを設定するか、URLを引数にしてNavigateメソッドを呼び出し、ページを表示するのが一般的だが、HTMLコードの文字列をWebページとして表示することも可能だ。ここではその方法を2つ紹介する。

DocumentTextプロパティによる表示

　1つ目の方法は非常にシンプルで、WebBrowserコントロールのDocumentTextプロパティに、HTMLの内容を含んだ文字列をセットするだけだ。

　次のサンプル・コードでは、WebClientクラス（System.Net名前空間）によりInsider.NETのトップ・ページのHTMLを取得し、それをWebBrowserコントロールに表示している。

// HTMLデータの取得 WebClient wc = new WebClient(); wc.Proxy = null; wc.Encoding = System.Text.Encoding.GetEncoding("Shift_JIS"); string html = wc.DownloadString("http://www.atmarkit.co.jp/fdotnet"); webBrowser1.DocumentText = html; ' HTMLデータの取得 Dim wc As New WebClient() wc.Proxy = Nothing wc.Encoding = System.Text.Encoding.GetEncoding("Shift_JIS") Dim html As String = wc.DownloadString("http://www.atmarkit.co.jp/fdotnet") WebBrowser1.DocumentText = html

DocumentTextプロパティによりHTMLを表示（上：C#、下：VB）

変数webBrowser1はWebBrowserコントロールを参照しているものとする。また、WebClientクラスを使用しているため、System.Net名前空間のインポートが必要。

　WebClientクラスの使い方については「TIPS：WebClientクラスでWebページを取得するには？」で解説している。

　なお、当然ながら、相対URLで記述されている要素（＝絶対URLで記述されていない要素。例えば「<img src="images/fdotnet_m.gif">」）については、正しく表示などが行えない。

OpenNew／Writeメソッドによる表示

　もう1つの方法は、WebBrowserコントロールに表示されているドキュメントを示すHtmlDocumentオブジェクト（Documentプロパティから取得できる）に対して、WriteメソッドによりHTMLを書き込む方法だ。メソッドの引数にはHTMLの内容を含んだ文字列を指定する。このとき、事前にOpenNewメソッドを呼び出すことにより、現在表示中のドキュメントの内容をクリアできる。

　ただし、アプリケーションの起動直後は、WebBrowserコントロールにHtmlDocumentオブジェクトが割り当てられていない。このため、下記のサンプル・コードのように、Navigateメソッドにより空白ページに移動するなどして、WebBrowserコントロールにページ表示をさせる処理が最初に必要となる。

// HTMLデータの取得 WebClient wc = new WebClient(); wc.Proxy = null; wc.Encoding = System.Text.Encoding.GetEncoding("Shift_JIS"); string html = wc.DownloadString("http://www.atmarkit.co.jp/fdotnet"); // アプリケーション起動直後はドキュメントが存在しない if (this.webBrowser1.Document == null) {   webBrowser1.Navigate("about:blank"); // 空白ページを開く } webBrowser1.Document.OpenNew(true); // クリア webBrowser1.Document.Write(html); // 書き込み ' HTMLデータの取得 Dim wc As New WebClient() wc.Proxy = Nothing wc.Encoding = System.Text.Encoding.GetEncoding("Shift_JIS") Dim html As String = wc.DownloadString("http://www.atmarkit.co.jp/fdotnet") ' アプリケーション起動直後はドキュメントが存在しない If WebBrowser1.Document = Nothing Then   WebBrowser1.Navigate("about:blank") ' 空白ページを開く End If WebBrowser1.Document.OpenNew(True) ' クリア WebBrowser1.Document.Write(html) '書き込み

WriteメソッドによりHTMLを表示（上：C#、下：VB）

変数webBrowser1はWebBrowserコントロールを参照しているものとする。また、WebClientクラスを使用しているため、System.Net名前空間のインポートが必要。

　なお、OpenNewメソッドの引数には、WebBrowserコントロールが保持する履歴の現在のエントリを新しいドキュメントで置き換えるかどうかを指定する。

2つの方法の違い

　以上、2つの方法を示したが、DocumentTextプロパティに文字列をセットした場合には、Navigating、Navigated、DocumentCompletedなどのイベントが発生するのに対して、Writeメソッドで文字列を書き込んだ場合には、これらのイベントは発生しない。これが2つの方法の大きな違いといえる。

利用可能バージョン：.NET Framework 2.0以降 カテゴリ：Windowsフォーム　処理対象：WebBrowserコントロール 使用ライブラリ：WebBrowserコントロール（System.Windows.Forms名前空間） 使用ライブラリ：WebClientクラス（System.Net名前空間） 使用ライブラリ：HtmlDocumentクラス（System.Windows.Forms名前空間） 関連TIPS：WebClientクラスでWebページを取得するには？

この記事と関連性の高い別の.NET TIPS WebBrowserコントロールによりWebページからリンクや画像を抽出するには？ WebBrowserコントロールで選択されている文字列をコピーするには？ WebBrowserコントロール内のテキストボックスに文字列をセットするには？ WPFアプリケーションでWebページを表示するには？ ［Silverlight 2］HTML要素のstyle属性のCSSプロパティを取得／設定するには？ このリストは、（株）デジタルアドバンテージが開発した 自動関連記事探索システム Jigsaw（ジグソー） により自動抽出したものです。 generated by

「.NET TIPS」

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）