WebBrowser.Url 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置当前文档的 URL。

public:
 property Uri ^ Url { Uri ^ get(); void set(Uri ^ value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.WebBrowserUriTypeConverter))]
public Uri? Url { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.WebBrowserUriTypeConverter))>]
member this.Url : Uri with get, set

Public Property Url As Uri

属性值

Uri

Uri，表示当前文档的名称。

属性

BindableAttribute TypeConverterAttribute

例外

ObjectDisposedException

此 WebBrowser 实例不再有效。

InvalidOperationException

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

ArgumentException

在设置此属性时指定的值不是绝对 URI。 有关详细信息，请参阅 IsAbsoluteUri。

示例

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

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

注解

设置此属性等效于调用 Navigate 方法并向其传递指定的 URL。

控件 WebBrowser 维护浏览会话期间访问的所有网页的历史记录列表。 设置 Url 属性时， WebBrowser 控件将导航到指定的 URL，并将其添加到历史记录列表的末尾。

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

注意

此属性包含当前文档的 URL，即使已请求其他文档也是如此。 如果设置此属性的值，然后立即再次检索它，则 WebBrowser 如果控件没有时间加载新文档，则检索的值可能与设置的值不同。 可以在事件处理程序中 DocumentCompleted 检索新值。

另请参阅

• Navigate
• DocumentCompleted
• WebBrowser 控件
• IWebBrowser2 接口