WebBrowser.Navigating イベント
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文Dim instance As WebBrowser Dim handler As WebBrowserNavigatingEventHandler AddHandler instance.Navigating, handler
public: event WebBrowserNavigatingEventHandler^ Navigating { void add (WebBrowserNavigatingEventHandler^ value); void remove (WebBrowserNavigatingEventHandler^ value); }
解説次のいずれかのプロパティが設定される、またはメソッドが呼び出されると、WebBrowser コントロールは必ず新しいドキュメントに移動します。
Navigating イベントを処理すると、たとえばユーザーがフォームへの入力を完了していない場合など、特定の条件が満たされなかった場合にナビゲーションをキャンセルできます。ナビゲーションをキャンセルするには、イベント ハンドラに渡される WebBrowserNavigatingEventArgs オブジェクトの Cancel プロパティを true に設定します。また、このオブジェクトを使用して新しいドキュメントの URL を WebBrowserNavigatingEventArgs.Url プロパティで取得することもできます。新しいドキュメントを Web ページのフレームに表示する場合、WebBrowserNavigatingEventArgs.TargetFrameName プロパティでフレーム名を取得できます。
Navigated イベントを処理すると、WebBrowser コントロールがナビゲーションを完了し、新しい位置でドキュメントの読み込みを開始したときに通知が送られます。DocumentCompleted イベントを処理すると、WebBrowser コントロールで新しいドキュメントの読み込みが終了したときに通知が送られます。
使用例Navigating イベントのハンドラを使用して、Web ページのフォームが入力されていない場合にナビゲーションをキャンセルする方法を次のコード例に示します。Document プロパティを使用してフォームの入力フィールドに値が含まれているかどうかを判断します。
この例は、webBrowser1 という名前の WebBrowser コントロールがフォームに配置され、COM からのアクセスを可能にする ComVisibleAttribute がフォーム クラスに指定されていることを前提としています。
次のコードを貼り付けることができるコード全体については、「方法 : Windows フォーム アプリケーションに Web ブラウザの機能を追加する」を参照してください。
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _ Handles Me.Load webBrowser1.DocumentText = _ "<html><body>Please enter your name:<br/>" & _ "<input type='text' name='userName'/><br/>" & _ "<a href='http://www.microsoft.com'>continue</a>" & _ "</body></html>" End Sub Private Sub webBrowser1_Navigating( _ ByVal sender As Object, ByVal e As WebBrowserNavigatingEventArgs) _ Handles webBrowser1.Navigating Dim document As System.Windows.Forms.HtmlDocument = _ webBrowser1.Document If document IsNot Nothing And _ document.All("userName") IsNot Nothing And _ String.IsNullOrEmpty( _ document.All("userName").GetAttribute("value")) Then e.Cancel = True MsgBox("You must enter your name before you can navigate to " & _ e.Url.ToString()) End If End Sub
private void Form1_Load(object sender, EventArgs e) { webBrowser1.DocumentText = "<html><body>Please enter your name:<br/>" + "<input type='text' name='userName'/><br/>" + "<a href='http://www.microsoft.com'>continue</a>" + "</body></html>"; webBrowser1.Navigating += new WebBrowserNavigatingEventHandler(webBrowser1_Navigating); } private void webBrowser1_Navigating(object sender, WebBrowserNavigatingEventArgs e) { System.Windows.Forms.HtmlDocument document = this.webBrowser1.Document; if (document != null && document.All["userName"] != null && String.IsNullOrEmpty( document.All["userName"].GetAttribute("value"))) { e.Cancel = true; System.Windows.Forms.MessageBox.Show( "You must enter your name before you can navigate to " + e.Url.ToString()); } }
.NET Framework のセキュリティプラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照WebBrowser クラス
WebBrowser メンバ
System.Windows.Forms 名前空間
WebBrowser.DocumentCompleted イベント
WebBrowser.DocumentStream プロパティ
WebBrowser.DocumentText プロパティ
GoBack
GoForward
GoHome
GoSearch
Navigate
WebBrowser.Navigated イベント
WebBrowser.Url プロパティ
WebBrowserNavigatingEventArgs
WebBrowserNavigatingEventHandler
その他の技術情報
イベントの利用
Weblioに収録されているすべての辞書からWebBrowser.Navigating イベントを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からWebBrowser.Navigating イベント
を検索
- WebBrowser.Navigating イベントのページへのリンク
