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)使用 方法巡覽至 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)使用 方法巡覽至 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)使用 方法巡覽至 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)使用 方法巡覽至 Uri 不包含逸出字元的 。