WebBrowser.Navigate 方法

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

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

将指定位置的文档加载到 WebBrowser 控件中。

重载

Navigate(Uri, String, Byte[], String)	将指定的 Uri 所指示的位置上的文档加载到 WebBrowser 控件中，使用指定 HTTP 数据请求该文档并替换具有指定名称的网页框架的内容。
Navigate(String, String, Byte[], String)	将指定的统一资源定位器 (URL) 处的文档加载到 WebBrowser 控件中，使用指定 HTTP 数据请求该文档并替换具有指定名称的网页框架的内容。
Navigate(Uri, Boolean)	将指定的 Uri 所指示的位置上的文档加载到浏览器新窗口或 WebBrowser 控件中。
Navigate(Uri, String)	将指定的 Uri 所指示的位置上的文档加载到 WebBrowser 控件中，替换具有指定名称的网页框架的内容。
Navigate(String, Boolean)	将指定的统一资源定位器 (URL) 处的文档加载到浏览器新窗口或 WebBrowser 控件中。
Navigate(String, String)	将指定的统一资源定位器 (URL) 处的文档加载到 WebBrowser 控件中，替换具有指定名称的网页框架的内容。
Navigate(Uri)	将指定的 Uri 所指示的位置上的文档加载到 WebBrowser 控件中，替换上一个文档。
Navigate(String)	将指定的统一资源定位器 (URL) 处的文档加载到 WebBrowser 控件中，替换上一个文档。

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

将指定的 Uri 所指示的位置上的文档加载到 WebBrowser 控件中，使用指定 HTTP 数据请求该文档并替换具有指定名称的网页框架的内容。

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

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

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

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

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

参数

url: Uri

Uri，表示要加载的文档的 URL。

targetFrameName: String

要在其中加载文档的框架的名称。

postData: Byte[]

HTTP POST 数据，例如窗体数据。

additionalHeaders: String

要添加到默认标头中的 HTTP 标头。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

ArgumentException

url 参数值不表示绝对 URI。有关详细信息，请参阅 IsAbsoluteUri。

注解

控件 WebBrowser 维护浏览会话期间访问的所有网页的历史记录列表。调用此重载时， WebBrowser 控件会将指定 URI 处的文档加载到具有指定名称的网页框架中，并将 URI 添加到历史记录列表的末尾。如果指定的框架名称无效，则会将文档加载到新的 Internet Explorer 窗口中。

GoBack使用方法将控件返回到导航历史记录中的上一页。使用方法在 GoForward 向后导航后返回到导航历史记录中的后续页面。

控件 WebBrowser 将最近访问过的网站的网页存储在本地硬盘上的缓存中。每个页面都可以指定一个过期日期，指示它在缓存中的保留时间。当控件导航到页面时，它通过显示缓存版本（如果可用）来节省时间，而不是再次下载页面。 Refresh使用方法通过下载来强制WebBrowser控件重新加载当前页，确保控件显示最新版本。

另请参阅

适用于

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

将指定的统一资源定位器 (URL) 处的文档加载到 WebBrowser 控件中，使用指定 HTTP 数据请求该文档并替换具有指定名称的网页框架的内容。

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

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

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

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

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

参数

urlString: String

要加载的文档的 URL。

targetFrameName: String

要在其中加载文档的框架的名称。

postData: Byte[]

HTTP POST 数据，例如窗体数据。

additionalHeaders: String

要添加到默认标头中的 HTTP 标头。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

注解

GoBack使用方法将控件返回到导航历史记录中的上一页。使用方法在 GoForward 向后导航后返回到导航历史记录中的后续页面。

另请参阅

适用于

Navigate(Uri, Boolean)

将指定的 Uri 所指示的位置上的文档加载到浏览器新窗口或 WebBrowser 控件中。

public:
 void Navigate(Uri ^ url, bool newWindow);

public void Navigate (Uri url, bool newWindow);

public void Navigate (Uri? url, bool newWindow);

member this.Navigate : Uri * bool -> unit

Public Sub Navigate (url As Uri, newWindow As Boolean)

参数

url: Uri

Uri，表示要加载的文档的 URL。

newWindow: Boolean

若要将文档加载到浏览器新窗口中，则为 true；若要将文档加载到 WebBrowser 控件中，则为 false。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

ArgumentException

url 参数值不表示绝对 URI。有关详细信息，请参阅 IsAbsoluteUri。

注解

控件 WebBrowser 维护浏览会话期间访问的所有网页的历史记录列表。使用参数值 false调用此重载newWindow时，控件将正常导航到指定的 URI，并将 URI 添加到历史记录列表的末尾。使用参数值 true调用此重载newWindow时，控件会将WebBrowser指定 URI 处的文档加载到新的 Internet Explorer 窗口中，该窗口维护自己的导航历史记录。可以在打开新浏览器窗口之前处理 NewWindow 事件以接收通知，从而在必要时取消操作。

控件 WebBrowser 将最近访问过的网站的网页存储在本地硬盘上的缓存中。每个页面都可以指定一个过期日期，指示它在缓存中的保留时间。当控件导航到页面或将页面加载到单独的浏览器窗口中时，它通过显示缓存版本（如果可用）来节省时间，而不是再次下载页面。 Refresh使用方法通过下载来强制WebBrowser控件重新加载当前页，确保控件显示最新版本。将页面加载到单独的 Internet Explorer 窗口中时，用户可以通过单击“ 刷新 ”按钮检索最新版本。

另请参阅

适用于

Navigate(Uri, String)

将指定的 Uri 所指示的位置上的文档加载到 WebBrowser 控件中，替换具有指定名称的网页框架的内容。

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName);

public void Navigate (Uri url, string targetFrameName);

public void Navigate (Uri? url, string? targetFrameName);

member this.Navigate : Uri * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String)

参数

url: Uri

Uri，表示要加载的文档的 URL。

targetFrameName: String

要在其中加载文档的框架的名称。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

ArgumentException

url 参数值不表示绝对 URI。有关详细信息，请参阅 IsAbsoluteUri。

注解

GoBack使用方法将控件返回到导航历史记录中的上一页。使用方法在 GoForward 向后导航后返回到导航历史记录中的后续页面。

另请参阅

适用于

Navigate(String, Boolean)

将指定的统一资源定位器 (URL) 处的文档加载到浏览器新窗口或 WebBrowser 控件中。

public:
 void Navigate(System::String ^ urlString, bool newWindow);

public void Navigate (string urlString, bool newWindow);

member this.Navigate : string * bool -> unit

Public Sub Navigate (urlString As String, newWindow As Boolean)

参数

urlString: String

要加载的文档的 URL。

newWindow: Boolean

若要将文档加载到浏览器新窗口中，则为 true；若要将文档加载到 WebBrowser 控件中，则为 false。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

注解

另请参阅

适用于

Navigate(String, String)

将指定的统一资源定位器 (URL) 处的文档加载到 WebBrowser 控件中，替换具有指定名称的网页框架的内容。

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName);

public void Navigate (string urlString, string targetFrameName);

public void Navigate (string urlString, string? targetFrameName);

member this.Navigate : string * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String)

参数

urlString: String

要加载的文档的 URL。

targetFrameName: String

要在其中加载文档的框架的名称。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

注解

GoBack使用方法将控件返回到导航历史记录中的上一页。使用方法在 GoForward 向后导航后返回到导航历史记录中的后续页面。

另请参阅

适用于

Navigate(Uri)

将指定的 Uri 所指示的位置上的文档加载到 WebBrowser 控件中，替换上一个文档。

public:
 void Navigate(Uri ^ url);

public void Navigate (Uri url);

public void Navigate (Uri? url);

member this.Navigate : Uri -> unit

Public Sub Navigate (url As Uri)

参数

url: Uri

Uri，表示要加载的文档的 URL。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

ArgumentException

url 参数值不表示绝对 URI。有关详细信息，请参阅 IsAbsoluteUri。

示例

下面的代码示例演示如何使用 Navigate 方法实现控件的 WebBrowser 地址栏。此示例要求窗体包含一WebBrowser个名为的控件、一TextBox个名为 webBrowser1的 TextBoxAddress控件和一个名为 Button 的ButtonGo控件。在文本框中键入 URL 并按 Enter 或单击“ 转到 ”按钮时， WebBrowser 控件将导航到指定的 URL。通过单击超链接进行导航时，文本框会自动更新以显示当前 URL。

有关完整代码示例，请参阅如何：向 Windows 窗体应用程序添加 Web 浏览器功能。

// Navigates to the URL in the address text box when 
// the ENTER key is pressed while the text box has focus.
void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
{
   if ( e->KeyCode == System::Windows::Forms::Keys::Enter &&  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Navigates to the URL in the address text box when 
// the Go button is clicked.
void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   if (  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Updates the URL in TextBoxAddress upon navigation.
void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ )
{
   this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString();
}

// Navigates to the URL in the address box when 
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when 
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}


' Navigates to the URL in the address box when 
' the ENTER key is pressed while the ToolStripTextBox has focus.
Private Sub toolStripTextBox1_KeyDown( _
    ByVal sender As Object, ByVal e As KeyEventArgs) _
    Handles toolStripTextBox1.KeyDown

    If (e.KeyCode = Keys.Enter) Then
        Navigate(toolStripTextBox1.Text)
    End If

End Sub

' Navigates to the URL in the address box when 
' the Go button is clicked.
Private Sub goButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles goButton.Click

    Navigate(toolStripTextBox1.Text)

End Sub

' Navigates to the given URL if it is valid.
Private Sub Navigate(ByVal address As String)

    If String.IsNullOrEmpty(address) Then Return
    If address.Equals("about:blank") Then Return
    If Not address.StartsWith("http://") And _
        Not address.StartsWith("https://") Then
        address = "http://" & address
    End If

    Try
        webBrowser1.Navigate(New Uri(address))
    Catch ex As System.UriFormatException
        Return
    End Try

End Sub

' Updates the URL in TextBoxAddress upon navigation.
Private Sub webBrowser1_Navigated(ByVal sender As Object, _
    ByVal e As WebBrowserNavigatedEventArgs) _
    Handles webBrowser1.Navigated

    toolStripTextBox1.Text = webBrowser1.Url.ToString()

End Sub

注解

控件 WebBrowser 维护浏览会话期间访问的所有网页的历史记录列表。调用此重载时， WebBrowser 控件会导航到指定的 URI，并将其添加到历史记录列表的末尾。 GoBack使用方法将控件返回到导航历史记录中的上一页。使用方法在 GoForward 向后导航后返回到导航历史记录中的后续页面。

可以使用 Navigate 方法实现类似于 Internet Explorer 中的地址栏。

另请参阅

适用于

Navigate(String)

将指定的统一资源定位器 (URL) 处的文档加载到 WebBrowser 控件中，替换上一个文档。

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

public void Navigate (string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

参数

urlString: String

要加载的文档的 URL。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

注解

可以使用 Navigate 方法实现类似于 Internet Explorer 中的地址栏。

另请参阅

适用于

通过

WebBrowser.Navigate 方法

定义

重载

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

参数

例外

注解

另请参阅

适用于

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

参数

例外

注解

另请参阅

适用于

Navigate(Uri, Boolean)

参数

例外

注解

另请参阅

适用于

Navigate(Uri, String)

参数

例外

注解

另请参阅

适用于

Navigate(String, Boolean)

参数

例外

注解

另请参阅

适用于

Navigate(String, String)

参数

例外

注解

另请参阅

适用于

Navigate(Uri)

参数

例外

示例

注解

另请参阅

适用于

Navigate(String)

参数

例外

注解

另请参阅

适用于

其他资源