WebBrowserNavigatingEventArgsとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

WebBrowserNavigatingEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

WebBrowser.Navigating イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class WebBrowserNavigatingEventArgs
    Inherits CancelEventArgs

Visual Basic (使用法)

Dim instance As WebBrowserNavigatingEventArgs

public class WebBrowserNavigatingEventArgs
 : CancelEventArgs

C++

public ref class WebBrowserNavigatingEventArgs
 : public CancelEventArgs

public class WebBrowserNavigatingEventArgs
 extends CancelEventArgs

JScript

public class WebBrowserNavigatingEventArgs
 extends CancelEventArgs

解説

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

使用例

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

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

継承階層

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Windows.Forms.WebBrowserNavigatingEventArgs

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
WebBrowserNavigatingEventArgs メンバ
System.Windows.Forms 名前空間
CancelEventArgs.Cancel
TargetFrameName
Url
WebBrowser クラス
WebBrowser.Navigating イベント

WebBrowserNavigatingEventArgs コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

WebBrowserNavigatingEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    url As Uri, _
    targetFrameName As String _
)

Visual Basic (使用法)

Dim url As Uri
Dim targetFrameName As String

Dim instance As New WebBrowserNavigatingEventArgs(url,
 targetFrameName)

public WebBrowserNavigatingEventArgs (
    Uri url,
    string targetFrameName
)

C++

public:
WebBrowserNavigatingEventArgs (
    Uri^ url, 
    String^ targetFrameName
)

public WebBrowserNavigatingEventArgs (
    Uri url, 
    String targetFrameName
)

JScript

public function WebBrowserNavigatingEventArgs
 (
    url : Uri, 
    targetFrameName : String
)

パラメータ

url: WebBrowser コントロールの移動先ドキュメントの場所を表す Uri。

targetFrameName: 新しいドキュメントが読み込まれる Web ページフレームの名前。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
WebBrowserNavigatingEventArgs クラス
WebBrowserNavigatingEventArgs メンバ
System.Windows.Forms 名前空間
WebBrowser クラス
WebBrowser.Navigating イベント

WebBrowserNavigatingEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Cancel	イベントをキャンセルするかどうかを示す値を取得または設定します。 ( CancelEventArgs から継承されます。)
	Url	WebBrowser コントロールの移動先であるドキュメントの場所を取得します。

参照

WebBrowserNavigatingEventArgs メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

WebBrowserNavigatingEventArgs メンバ

WebBrowser.Navigating イベントのデータを提供します。

WebBrowserNavigatingEventArgs データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	WebBrowserNavigatingEventArgs	WebBrowserNavigatingEventArgs クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	Cancel	イベントをキャンセルするかどうかを示す値を取得または設定します。(CancelEventArgs から継承されます。)
	Url	WebBrowser コントロールの移動先であるドキュメントの場所を取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

WebBrowserNavigatingEventArgsとは？わかりやすく解説

WebBrowserNavigatingEventArgs クラス

WebBrowserNavigatingEventArgs コンストラクタ

WebBrowserNavigatingEventArgs プロパティ

関連項目

WebBrowserNavigatingEventArgs メソッド

関連項目

WebBrowserNavigatingEventArgs メンバ

関連項目

「WebBrowserNavigatingEventArgs」の関連用語


	© 2025 Microsoft.All rights reserved.

WebBrowserNavigatingEventArgsとは？ わかりやすく解説

WebBrowserNavigatingEventArgs クラス

WebBrowserNavigatingEventArgs コンストラクタ

WebBrowserNavigatingEventArgs プロパティ

関連項目

WebBrowserNavigatingEventArgs メソッド

関連項目

WebBrowserNavigatingEventArgs メンバ

関連項目

急上昇のことば

「WebBrowserNavigatingEventArgs」の関連用語

WebBrowserNavigatingEventArgsとは？わかりやすく解説