WebBrowser.Url Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die URL des aktuellen Dokuments ab oder legt diese fest.

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

Eigenschaftswert

Uri

Ein Uri, der die URL des aktuellen Dokuments darstellt.

Attribute: BindableAttribute TypeConverterAttribute

Ausnahmen

ObjectDisposedException

Diese WebBrowser-Instanz ist nicht mehr gültig.

InvalidOperationException

Aus dem zugrunde liegenden ActiveX-IWebBrowser2-Steuerelement konnte kein Verweis auf eine Implementierung der WebBrowser-Schnittstelle abgerufen werden.

ArgumentException

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kein absoluter URI. Weitere Informationen finden Sie unter IsAbsoluteUri.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Url -Eigenschaft verwendet wird, um eine Adressleiste für das WebBrowser Steuerelement zu implementieren. In diesem Beispiel muss das Formular ein WebBrowser -Steuerelement mit dem Namen webBrowser1, ein TextBox -Steuerelement mit dem Namen TextBoxAddressund ein Button -Steuerelement mit dem Namen ButtonGoenthält. Wenn Sie eine URL in das Textfeld eingeben und die EINGABETASTE drücken oder auf die Schaltfläche Go klicken, navigiert das WebBrowser Steuerelement zu der angegebenen URL. Wenn Sie durch Klicken auf einen Link navigieren, wird das Textfeld automatisch aktualisiert, um die aktuelle URL anzuzeigen.

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

Hinweise

Das Festlegen dieser Eigenschaft entspricht dem Aufrufen der Navigate -Methode und der Übergabe der angegebenen URL.

Das WebBrowser Steuerelement verwaltet eine Verlaufsliste aller Webseiten, die während einer Browsersitzung besucht wurden. Wenn Sie die Url -Eigenschaft festlegen, navigiert das WebBrowser Steuerelement zur angegebenen URL und fügt sie am Ende der Verlaufsliste hinzu.

Das WebBrowser Steuerelement speichert Webseiten von kürzlich besuchten Websites in einem Cache auf der lokalen Festplatte. Jede Seite kann ein Ablaufdatum angeben, das angibt, wie lange sie im Cache verbleibt. Wenn das Steuerelement zu einer Seite navigiert, spart es Zeit, indem es eine zwischengespeicherte Version anzeigt, sofern verfügbar, anstatt die Seite erneut herunterzuladen. Verwenden Sie die Refresh -Methode, um zu erzwingen, dass das WebBrowser Steuerelement die aktuelle Seite erneut lädt, indem Sie sie herunterladen, um sicherzustellen, dass das Steuerelement die neueste Version anzeigt.

Hinweis

Diese Eigenschaft enthält die URL des aktuellen Dokuments, auch wenn ein anderes Dokument angefordert wurde. Wenn Sie den Wert dieser Eigenschaft festlegen und ihn dann sofort wieder abrufen, kann sich der abgerufene Wert von dem festgelegten Wert unterscheiden, wenn das WebBrowser Steuerelement keine Zeit zum Laden des neuen Dokuments hatte. Sie können den neuen Wert in einem DocumentCompleted Ereignishandler abrufen.

Gilt für:

Freigeben über