WebBrowser コントロールを使用すると、ブラウザで表示できるドキュメント (Web ページなど) を Windows フォーム アプリケーションでホストできます。たとえば WebBrowser コントロールを使用して、HTML ベースのユーザー支援機能や Web ブラウズ機能をアプリケーションに統合できます。さらに WebBrowser コントロールを使用して、既存の Web ベース コントロールを Windows フォーム クライアント アプリケーションに追加することもできます。
重要 : |
|---|
| WebBrowser は、リソースへの負荷の大きいコントロールです。コントロールの使用を終えたら、必ず Dispose メソッドを呼び出し、すべてのリソースを確実に解放するようにしてください。Dispose メソッドは、イベントを結びつけたスレッドと同じスレッドで呼び出す必要があります。イベントを結びつけるスレッドは、常にメッセージ スレッドまたはユーザー インターフェイス (UI) スレッドのいずれかになります。 |
WebBrowser コントロールは、信頼性が一部しか確認されていないコードでは使用できません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
WebBrowser コントロールには、ナビゲーションに関する複数のプロパティ、メソッド、イベントがあります。次に示すメンバを使用して、コントロールを特定の URL に移動することや、ナビゲーション履歴リストの中を前後に移動すること、および現在のユーザーのホーム ページや検索ページを読み込むことができます。
ナビゲーションに失敗した場合、問題を示すページが表示されます。これらのいずれかのメンバを使用したナビゲーションにより、ナビゲーションのさまざまな段階で Navigating イベント、Navigated イベント、および DocumentCompleted イベントが発生します。
これらのメンバや、Stop メソッドや Refresh メソッドなどのメンバを利用して、Internet Explorer に似たユーザー インターフェイス コントロールをアプリケーションに実装できます。WebBrowser コントロールをフォームに表示しない場合でも、一部のメンバは役立ちます。たとえば、Print メソッドを使用すると、Web ページをユーザーに表示せずに最新の Web ページを印刷できます。
また WebBrowser コントロールを使用すると、アプリケーションで作成したコンテンツや、データベースまたはリソース ファイルから取得したコンテンツを表示できます。DocumentText プロパティまたは DocumentStream プロパティを使用すると、現在のドキュメントの内容を文字列またはデータ ストリームとして取得または設定できます。
また、Document プロパティを使用して Web ページのコンテンツを操作することもできます。このプロパティには、現在のページの HTML ドキュメント オブジェクト モデル (DOM: Document Object Model) へのマネージ アクセスを提供する HtmlDocument オブジェクトが格納されています。このプロパティを ObjectForScripting プロパティと組み合わせて使用し、アプリケーションのコードと Web ページのダイナミック HTML (DHTML) コードとの双方向通信を実装することで、Web ベースのコントロールと Windows フォーム コントロールを 1 つのユーザー インターフェイスに統合できます。Document プロパティを使用して、アプリケーションからスクリプト コードのメソッドを呼び出すことができます。スクリプト コードにより、window.external オブジェクトを介してアプリケーションにアクセスできます。このオブジェクトはホスト アクセス用に提供される組み込み DOM オブジェクトであり、ObjectForScripting プロパティで指定されたオブジェクトに割り当てられます。
メモ |
|---|
| このクラスによって、クラス レベルでのセキュリティ要求が行われます。派生クラスまたはコール スタック内の呼び出し元に、完全に信頼されたアクセス許可が設定されていない場合、SecurityException がスローされます。セキュリティ要求の詳細については、「リンク確認要求」および「継承確認要求」を参照してください。 |
メモ |
|---|
| WebBrowser クラスは、シングル スレッド アパートメント (STA: Single Thread Apartment) モードに設定されているスレッドでだけ使用できます。このクラスを使用するには、Main メソッドが確実に STAThreadAttribute 属性でマークされているようにします。 |
Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows CE プラットフォームメモ :
.NET Compact Framework アプリケーションで WebBrowser の機能をすべて利用するには、Pocket PC および Smartphone 用 Windows Mobile Version 5.0 ソフトウェアが必要です。詳細については、「方法 : .NET Compact Framework で WebBrowser コントロールを使用する」を参照してください。