WebBrowser.Navigate 方法

参考

定义

命名空间:: System.Windows.Controls

程序集:: PresentationFramework.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

异步导航到位于指定 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