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)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将文档加载到控件中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)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将位于指定统一资源定位符（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)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将文档加载到指定 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 将文档加载到新的浏览器窗口中; false 将文档加载到控件中 WebBrowser 。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

无法从基础 ActiveX IWebBrowser2 控件检索对接口实现的WebBrowser引用。

ArgumentException

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

注解

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

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

另请参阅

适用于

Navigate(Uri, String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将文档加载到控件中指定的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)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将位于指定统一资源定位符（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 将文档加载到新的浏览器窗口中; false 将文档加载到控件中 WebBrowser 。

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

无法从基础 ActiveX IWebBrowser2 控件检索对接口实现的WebBrowser引用。

注解

另请参阅

适用于

Navigate(String, String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将位于指定统一资源定位符（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)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将文档加载到指定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、一webBrowser1TextBox个名为TextBoxAddress控件和一个名为Button控件的ButtonGo控件。在文本框中键入 URL 并按 Enter 或单击 Go 按钮时，控件 WebBrowser 将导航到指定的 URL。单击超链接导航时，文本框会自动更新以显示当前 URL。

有关完整的代码示例，请参阅 How to： Add Web Browser Capabilities to a Windows 窗体 Application。

// 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)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

将位于指定统一资源定位符（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中的地址栏。

另请参阅

适用于

反馈

此页面是否有帮助？