WebBrowser.Url Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

WebBrowser.cs

Získá nebo nastaví adresu URL aktuálního dokumentu.

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

Představuje Uri adresu URL aktuálního dokumentu.

Atributy

BindableAttribute TypeConverterAttribute

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

ArgumentException

Zadaná hodnota při nastavení této vlastnosti není absolutní identifikátor URI. Další informace najdete na webu IsAbsoluteUri.

Příklady

Následující příklad kódu ukazuje použití Url vlastnosti k implementaci adresního řádku pro WebBrowser ovládací prvek. Tento příklad vyžaduje, aby formulář obsahuje WebBrowser ovládací prvek s názvem , TextBox s webBrowser1názvem TextBoxAddressovládacího prvku a Button s názvem ButtonGoovládacího prvku . Když do textového pole zadáte adresu URL a stisknete enter nebo kliknete na tlačítko Přejít , WebBrowser ovládací prvek přejde na zadanou adresu URL. Když přejdete kliknutím na hypertextový odkaz, textové pole se automaticky aktualizuje, aby se zobrazila aktuální adresa 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.

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Když nastavíte Url vlastnost, WebBrowser ovládací prvek přejde na zadanou adresu URL a přidá ji na konec seznamu historie.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, místo opětovného stažení stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi.

Poznámka:

Tato vlastnost obsahuje adresu URL aktuálního dokumentu, i když byl požadován jiný dokument. Pokud nastavíte hodnotu této vlastnosti a pak ji okamžitě načtete znovu, může být načtená hodnota jiná než hodnota nastavená, pokud WebBrowser ovládací prvek neměl čas načíst nový dokument. Novou hodnotu můžete načíst v obslužné rutině DocumentCompleted události.

Viz také

• Navigate
• DocumentCompleted
• Ovládací prvek WebBrowser
• IWebBrowser2 – rozhraní