WebBrowser.Navigating イベントとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > WebBrowser.Navigating イベントの意味・解説 

WebBrowser.Navigating イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

WebBrowser コントロールが新しいドキュメントに移動する前に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文構文

Public Event Navigating As
 WebBrowserNavigatingEventHandler
Dim instance As WebBrowser
Dim handler As WebBrowserNavigatingEventHandler

AddHandler instance.Navigating, handler
public event WebBrowserNavigatingEventHandler Navigating
public:
event WebBrowserNavigatingEventHandler^ Navigating {
    void add (WebBrowserNavigatingEventHandler^ value);
    void remove (WebBrowserNavigatingEventHandler^ value);
}
/** @event */
public void add_Navigating (WebBrowserNavigatingEventHandler
 value)

/** @event */
public void remove_Navigating (WebBrowserNavigatingEventHandler
 value)
JScript では、イベントは使用できますが、新規に宣言することはできません。
解説解説

次のいずれかのプロパティが設定される、またはメソッドが呼び出されると、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 のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
WebBrowser クラス
WebBrowser メンバ
System.Windows.Forms 名前空間
WebBrowser.DocumentCompleted イベント
WebBrowser.DocumentStream プロパティ
WebBrowser.DocumentText プロパティ
GoBack
GoForward
GoHome
GoSearch
Navigate
WebBrowser.Navigated イベント
WebBrowser.Url プロパティ
WebBrowserNavigatingEventArgs
WebBrowserNavigatingEventHandler
その他の技術情報
イベントの利用



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「WebBrowser.Navigating イベント」の関連用語

WebBrowser.Navigating イベントのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



WebBrowser.Navigating イベントのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS