WebBrowser.Url Eigenschap

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

Waarde van eigenschap

Een Uri weergave van de URL van het huidige document.

Kenmerken

BindableAttribute TypeConverterAttribute

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Url eigenschap gebruikt om een adresbalk voor het WebBrowser besturingselement te implementeren. In dit voorbeeld is vereist dat uw formulier een besturingselement bevat met de WebBrowser naam , een webBrowser1 besturingselement dat wordt aangeroepen en een TextBox besturingselement dat wordt aangeroepenTextBoxAddressButton.ButtonGo Wanneer u een URL in het tekstvak typt en op Enter drukt of op de knop Start klikt, gaat het WebBrowser besturingselement naar de opgegeven URL. Wanneer u navigeert door op een hyperlink te klikken, wordt het tekstvak automatisch bijgewerkt om de huidige URL weer te geven.

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

Opmerkingen

Het instellen van deze eigenschap is gelijk aan het aanroepen van de Navigate methode en het doorgeven van de opgegeven URL.

Het WebBrowser besturingselement onderhoudt een geschiedenislijst met alle webpagina's die tijdens een browsersessie worden bezocht. Wanneer u de Url eigenschap instelt, gaat het WebBrowser besturingselement naar de opgegeven URL en voegt het toe aan het einde van de geschiedenislijst.

In het WebBrowser besturingselement worden webpagina's van onlangs bezochte sites opgeslagen in een cache op de lokale harde schijf. Elke pagina kan een vervaldatum opgeven die aangeeft hoe lang deze in de cache blijft. Wanneer het besturingselement naar een pagina navigeert, bespaart het tijd door een versie in de cache weer te geven, indien beschikbaar, in plaats van de pagina opnieuw te downloaden. Gebruik de Refresh methode om af te dwingen dat het WebBrowser besturingselement de huidige pagina opnieuw laadt door deze te downloaden, zodat het besturingselement de nieuwste versie weergeeft.

Zie ook

• Navigate
• DocumentCompleted
• WebBrowser-controle
• IWebBrowser2-interface