WebBrowser.Navigating イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebBrowser.Navigating イベント

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

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

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

Visual Basic (宣言)

Public Event Navigating As
 WebBrowserNavigatingEventHandler

Visual Basic (使用法)

Dim instance As WebBrowser
Dim handler As WebBrowserNavigatingEventHandler

AddHandler instance.Navigating, handler

public event WebBrowserNavigatingEventHandler Navigating

C++

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

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

次のいずれかのプロパティが設定される、またはメソッドが呼び出されると、WebBrowser コントロールは必ず新しいドキュメントに移動します。

Url
DocumentText
DocumentStream
Navigate
GoBack
GoForward
GoHome
GoSearch

Navigating イベントを処理すると、たとえばユーザーがフォームへの入力を完了していない場合など、特定の条件が満たされなかった場合にナビゲーションをキャンセルできます。ナビゲーションをキャンセルするには、イベントハンドラに渡される WebBrowserNavigatingEventArgs オブジェクトの Cancel プロパティを true に設定します。また、このオブジェクトを使用して新しいドキュメントの URL を WebBrowserNavigatingEventArgs.Url プロパティで取得することもできます。新しいドキュメントを Web ページのフレームに表示する場合、WebBrowserNavigatingEventArgs.TargetFrameName プロパティでフレーム名を取得できます。

Navigated イベントを処理すると、WebBrowser コントロールがナビゲーションを完了し、新しい位置でドキュメントの読み込みを開始したときに通知が送られます。DocumentCompleted イベントを処理すると、WebBrowser コントロールで新しいドキュメントの読み込みが終了したときに通知が送られます。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

Navigating イベントのハンドラを使用して、Web ページのフォームが入力されていない場合にナビゲーションをキャンセルする方法を次のコード例に示します。Document プロパティを使用してフォームの入力フィールドに値が含まれているかどうかを判断します。

この例は、webBrowser1 という名前の WebBrowser コントロールがフォームに配置され、COM からのアクセスを可能にする ComVisibleAttribute がフォームクラスに指定されていることを前提としています。

次のコードを貼り付けることができるコード全体については、「方法 : Windows フォームアプリケーションに Web ブラウザの機能を追加する」を参照してください。

Visual Basic

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());
    }
}