WebBrowser.Url Vlastnost

Definice

Získá nebo nastaví adresu URL aktuálního dokumentu.Gets or sets the URL of the current document.

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

Hodnota vlastnosti

Uri

UriPředstavuje adresu URL aktuálního dokumentu.A Uri representing the URL of the current document.

Atributy

Výjimky

Tato WebBrowser instance již není platná.This WebBrowser instance is no longer valid.

IWebBrowser2Z podkladového ovládacího prvku ActiveX nelze načíst odkaz na implementaci rozhraní WebBrowser .A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Zadaná hodnota při nastavení této vlastnosti není absolutní identifikátor URI.The specified value when setting this property is not an absolute URI. Další informace naleznete v tématu IsAbsoluteUri.For more information, see IsAbsoluteUri.

Příklady

Následující příklad kódu ukazuje, jak použít Url vlastnost k implementaci adresního řádku WebBrowser ovládacího prvku.The following code example demonstrates how to use the Url property to implement an address bar for the WebBrowser control. Tento příklad vyžaduje, aby formulář obsahoval WebBrowser ovládací prvek s názvem webBrowser1 , TextBox ovládací prvek s názvem TextBoxAddress a Button ovládací prvek s názvem ButtonGo .This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. Když zadáte adresu URL do textového pole a stisknete klávesu ENTER nebo kliknete na tlačítko Přejít , WebBrowser ovládací prvek přejde na zadanou adresu URL.When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. Když přejdete kliknutím na hypertextový odkaz, textové pole se automaticky aktualizuje a zobrazí aktuální adresu URL.When you navigate by clicking a hyperlink, the text box automatically updates to display the current 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

Poznámky

Nastavení této vlastnosti je ekvivalentní volání Navigate metody a předání zadané adresy URL.Setting this property is equivalent to calling the Navigate method and passing it the specified URL.

WebBrowserOvládací prvek udržuje seznam historie všech webových stránek navštívených během relace procházení.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Když nastavíte Url vlastnost, WebBrowser ovládací prvek přejde na zadanou adresu URL a přidá ho na konec seznamu historie.When you set the Url property, the WebBrowser control navigates to the specified URL and adds it to the end of the history list.

WebBrowserOvládací prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Na každé stránce může být zadáno datum vypršení platnosti, které určuje, jak dlouho zůstane mezipaměť v mezipaměti.Each page can specify an expiration date indicating how long it will remain in the cache. Když ovládací prvek přejde na stránku, šetří čas zobrazením verze v mezipaměti, pokud je k dispozici, místo opětovného stahování stránky.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Použijte Refresh metodu pro vynucení WebBrowser opětovného načtení aktuální stránky tím, že se aplikace stáhne a zajistí, že ovládací prvek zobrazí nejnovější verzi.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Poznámka

Tato vlastnost obsahuje adresu URL aktuálního dokumentu, a to i v případě, že byl požadován jiný dokument.This property contains the URL of the current document, even if another document has been requested. Pokud nastavíte hodnotu této vlastnosti a potom ji hned znovu načtete, načtená hodnota se může lišit od hodnoty nastavené v případě, že WebBrowser ovládací prvek nemá čas načíst nový dokument.If you set the value of this property and then immediately retrieve it again, the value retrieved may be different than the value set if the WebBrowser control has not had time to load the new document. Novou hodnotu lze načíst v DocumentCompleted obslužné rutině události.You can retrieve the new value in a DocumentCompleted event handler.

Platí pro

Viz také