WebBrowser.Navigate 方法

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)

参数

例外

注解

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

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

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

另请参阅

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控件
• IWebBrowser2 接口

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)

参数

例外

注解

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

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

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

另请参阅

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控件
• IWebBrowser2 接口

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)

参数

例外

注解

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

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

另请参阅

• GoBack()
• GoForward()
• NewWindow
• Refresh()
• WebBrowser 控件
• IWebBrowser2 接口

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)

参数

例外

注解

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

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

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

另请参阅

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控件
• IWebBrowser2 接口

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)

参数

例外

注解

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

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

另请参阅

• GoBack()
• GoForward()
• NewWindow
• Refresh()

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)

参数

例外

注解

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

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

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

另请参阅

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控件
• IWebBrowser2 接口

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)

参数

例外

示例

下面的代码示例演示如何使用 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 向后导航后返回到导航历史记录中的后续页面。

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

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

另请参阅

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控件
• IWebBrowser2 接口

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

public void Navigate (string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

参数

例外

注解

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

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

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

另请参阅

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控件
• IWebBrowser2 接口