WebBrowser.Navigate メソッド

定義

名前空間:

System.Windows.Controls

アセンブリ:

PresentationFramework.dll

指定された Uri にあるドキュメントに非同期に移動します。

オーバーロード

Navigate(String, String, Byte[], String)	指定された URL にあるドキュメントに非同期に移動し、ドキュメントのコンテンツを読み込むターゲット フレームを指定します。 追加の HTTP POST データおよび HTTP ヘッダーを、ナビゲーション要求の一部としてサーバーに送信できます。
Navigate(Uri, String, Byte[], String)	指定された Uri にあるドキュメントに非同期に移動し、ドキュメントのコンテンツを読み込むターゲット フレームを指定します。 追加の HTTP POST データおよび HTTP ヘッダーを、ナビゲーション要求の一部としてサーバーに送信できます。
Navigate(String)	指定された URL にあるドキュメントに非同期に移動します。
Navigate(Uri)	指定された Uri にあるドキュメントに非同期に移動します。

Navigate(String, String, Byte[], String)

指定された URL にあるドキュメントに非同期に移動し、ドキュメントのコンテンツを読み込むターゲット フレームを指定します。 追加の HTTP POST データおよび HTTP ヘッダーを、ナビゲーション要求の一部としてサーバーに送信できます。

public:
 void Navigate(System::String ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate (string source, string targetFrameName, byte[] postData, string additionalHeaders);

member this.Navigate : string * string * byte[] * string -> unit

Public Sub Navigate (source As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

パラメーター

source

String

移動先の URL。

targetFrameName

String

ドキュメントのコンテンツを表示するフレームの名前。

postData

Byte[]

ソースが要求されたときにサーバーに送信する HTTP POST データ。

additionalHeaders

String

ソースが要求されたときにサーバーに送信する HTTP ヘッダー。

注釈

エスケープ文字を Navigate(String, String, Byte[], String) 含む URL に移動するには、このメソッドを使用します。 エスケープ文字を Navigate(Uri, String, Byte[], String) 含まない a Uri に移動するには、このメソッドを使用します。

Navigate(Uri, String, Byte[], String)

指定された Uri にあるドキュメントに非同期に移動し、ドキュメントのコンテンツを読み込むターゲット フレームを指定します。 追加の HTTP POST データおよび HTTP ヘッダーを、ナビゲーション要求の一部としてサーバーに送信できます。

public:
 void Navigate(Uri ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate (Uri source, string targetFrameName, byte[] postData, string additionalHeaders);

member this.Navigate : Uri * string * byte[] * string -> unit

Public Sub Navigate (source As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

パラメーター

source

Uri

移動先の Uri。

targetFrameName

String

ドキュメントのコンテンツを表示するフレームの名前。

postData

Byte[]

ソースが要求されたときにサーバーに送信する HTTP POST データ。

additionalHeaders

String

ソースが要求されたときにサーバーに送信する HTTP ヘッダー。

例外

ObjectDisposedException

WebBrowser インスタンスは無効になりました。

InvalidOperationException

基になるネイティブ WebBrowser への参照を取得できませんでした。

SecurityException

部分信頼で実行されているアプリケーションからの移動。

• 起点サイトにない Uri へ、または
• targetFrameName 名が null ではないか、空です。

例

次の例は、ドキュメントに移動し、"about:blank" ターゲットを指定して新しいブラウザー ウィンドウで開く方法を示しています。

<StackPanel>  
    <StackPanel Orientation="Horizontal">  
        <TextBox x:Name="addressTextBox" Width="200" />  
        <Button Click="goNavigateButton_Click">Go</Button>  
    </StackPanel>  
    <WebBrowser x:Name="myWebBrowser" />  
</StackPanel>  

private void goNavigateButton_Click(object sender, RoutedEventArgs e)  
{  
    // Get URI to navigate to  
    Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);  

    // Only absolute URIs can be navigated to  
    if (!uri.IsAbsoluteUri)  
    {  
        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
        return;  
    }  

    // Navigate to the desired URL by calling the .Navigate method  
    this.myWebBrowser.Navigate(uri, "_blank", null, null);  
}  

注釈

エスケープ文字を Navigate(String, String, Byte[], String) 含む URL に移動するには、このメソッドを使用します。 エスケープ文字を Navigate(Uri, String, Byte[], String) 含まない a Uri に移動するには、このメソッドを使用します。

Navigate(String)

指定された URL にあるドキュメントに非同期に移動します。

public:
 void Navigate(System::String ^ source);

public void Navigate (string source);

member this.Navigate : string -> unit

Public Sub Navigate (source As String)

パラメーター

source

String

移動先の URL。

注釈

エスケープ文字を Navigate(String) 含む URL に移動するには、このメソッドを使用します。 エスケープ文字を Navigate(Uri) 含まない a Uri に移動するには、このメソッドを使用します。

Navigate(Uri)

指定された Uri にあるドキュメントに非同期に移動します。

public:
 void Navigate(Uri ^ source);

public void Navigate (Uri source);

member this.Navigate : Uri -> unit

Public Sub Navigate (source As Uri)

パラメーター

source

Uri

移動先の Uri。

例外

ObjectDisposedException

WebBrowser インスタンスは無効になりました。

InvalidOperationException

基になるネイティブ WebBrowser への参照を取得できませんでした。

SecurityException

部分信頼で実行されているアプリケーションから、起点にない Uri への移動。

例

次の例は、メソッドを使用 WebBrowser してドキュメントに移動する方法を Navigate(Uri) 示しています。

<StackPanel>  
    <StackPanel Orientation="Horizontal">  
        <TextBox x:Name="addressTextBox" Width="200" />  
        <Button Click="goNavigateButton_Click">Go</Button>  
    </StackPanel>  
    <WebBrowser x:Name="myWebBrowser" />  
</StackPanel>  

private void goNavigateButton_Click(object sender, RoutedEventArgs e)  
{  
    // Get URI to navigate to  
    Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);  

    // Only absolute URIs can be navigated to  
    if (!uri.IsAbsoluteUri)  
    {  
        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
        return;  
    }  

    // Navigate to the desired URL by calling the .Navigate method  
    this.myWebBrowser.Navigate(uri);  
}  

注釈

呼び出し Navigate(Uri) は、プロパティの設定と同じ効果があります Source 。 Sourceは、初期化時WebBrowserに移動する最初のドキュメントWebBrowserを宣言によって指定する開発者によってマークアップから使用されます。

エスケープ文字を Navigate(String) 含む URL に移動するには、このメソッドを使用します。 エスケープ文字を Navigate(Uri) 含まない a Uri に移動するには、このメソッドを使用します。