WebBrowser.Navigate Methode

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.

Lädt das Dokument am angegebenen Speicherort in das WebBrowser-Steuerelement.

Überlädt

Navigate(Uri, String, Byte[], String)	Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, anhand der angegebenen HTTP-Daten in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.
Navigate(String, String, Byte[], String)	Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) anhand der angegebenen HTTP-Daten in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.
Navigate(Uri, Boolean)	Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, in ein neues Browserfenster oder in das WebBrowser-Steuerelement.
Navigate(Uri, String)	Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.
Navigate(String, Boolean)	Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) in ein neues Browserfenster oder in das WebBrowser-Steuerelement.
Navigate(String, String)	Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.
Navigate(Uri)	Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, in das WebBrowser-Steuerelement und ersetzt dabei das vorherige Dokument.
Navigate(String)	Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) in das WebBrowser-Steuerelement und ersetzt dabei das vorherige Dokument.

Navigate(Uri, String, Byte[], String)

Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, anhand der angegebenen HTTP-Daten in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate (Uri url, string targetFrameName, byte[] postData, string additionalHeaders);

public void Navigate (Uri? url, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : Uri * string * byte[] * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parameter

url: Uri

Ein Uri, der die URL des zu ladenden Dokuments darstellt.

targetFrameName: String

Der Name des Frames, in den das Dokument geladen werden soll.

postData: Byte[]

HTTP-POST-Daten, z. B. Formulardaten.

additionalHeaders: String

HTTP-Header, die den Standardheadern hinzugefügt werden sollen.

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 Wert des url-Parameters stellt keinen absoluten URI dar. Weitere Informationen finden Sie unter IsAbsoluteUri.

Hinweise

Das WebBrowser Steuerelement verwaltet eine Verlaufsliste aller Webseiten, die während einer Browsersitzung besucht wurden. Wenn Sie diese Überladung aufrufen, lädt das WebBrowser Steuerelement das Dokument am angegebenen URI mit dem angegebenen Namen in den Webseitenframe und fügt den URI am Ende der Verlaufsliste hinzu. Wenn der angegebene Framename ungültig ist, wird das Dokument in ein neues Internet Explorer-Fenster geladen.

Verwenden Sie die GoBack -Methode, um das Steuerelement an eine vorherige Seite im Navigationsverlauf zurückzugeben. Verwenden Sie die GoForward -Methode, um zu einer späteren Seite im Navigationsverlauf zurückzukehren, nachdem Sie rückwärts navigiert haben.

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.

Weitere Informationen

Gilt für:

Navigate(String, String, Byte[], String)

Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) anhand der angegebenen HTTP-Daten in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate (string urlString, string targetFrameName, byte[] postData, string additionalHeaders);

public void Navigate (string urlString, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : string * string * byte[] * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parameter

urlString: String

Die URL des zu ladenden Dokuments.

targetFrameName: String

Der Name des Frames, in den das Dokument geladen werden soll.

postData: Byte[]

HTTP-POST-Daten, z. B. Formulardaten.

additionalHeaders: String

HTTP-Header, die den Standardheadern hinzugefügt werden sollen.

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.

Hinweise

Weitere Informationen

Gilt für:

Navigate(Uri, Boolean)

Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, in ein neues Browserfenster oder in das WebBrowser-Steuerelement.

public:
 void Navigate(Uri ^ url, bool newWindow);

public void Navigate (Uri url, bool newWindow);

public void Navigate (Uri? url, bool newWindow);

member this.Navigate : Uri * bool -> unit

Public Sub Navigate (url As Uri, newWindow As Boolean)

Parameter

url: Uri

Ein Uri, der die URL des zu ladenden Dokuments darstellt.

newWindow: Boolean

true, wenn das Dokument in ein neues Browserfenster geladen werden soll, false, wenn es in das WebBrowser-Steuerelement geladen werden soll.

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 Wert des url-Parameters stellt keinen absoluten URI dar. Weitere Informationen finden Sie unter IsAbsoluteUri.

Hinweise

Das WebBrowser Steuerelement verwaltet eine Verlaufsliste aller Webseiten, die während einer Browsersitzung besucht wurden. Wenn Sie diese Überladung mit dem newWindow Parameterwert aufrufen false, navigiert das Steuerelement normal zum angegebenen URI und fügt den URI am Ende der Verlaufsliste hinzu. Wenn Sie diese Überladung mit dem newWindow Parameterwert aufrufen true, lädt das WebBrowser Steuerelement das Dokument am angegebenen URI in ein neues Internet Explorer-Fenster, das seinen eigenen Navigationsverlauf verwaltet. Sie können das NewWindow Ereignis behandeln, um eine Benachrichtigung zu erhalten, bevor ein neues Browserfenster geöffnet wird, sodass Sie die Aktion bei Bedarf abbrechen können.

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 oder eine Seite in ein separates Browserfenster lädt, 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. Wenn eine Seite in ein separates Internet Explorer-Fenster geladen wird, kann der Benutzer die neueste Version abrufen, indem er auf die Schaltfläche Aktualisieren klickt.

Weitere Informationen

Gilt für:

Navigate(Uri, String)

Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName);

public void Navigate (Uri url, string targetFrameName);

public void Navigate (Uri? url, string? targetFrameName);

member this.Navigate : Uri * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String)

Parameter

url: Uri

Ein Uri, der die URL des zu ladenden Dokuments darstellt.

targetFrameName: String

Der Name des Frames, in den das Dokument geladen werden soll.

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 Wert des url-Parameters stellt keinen absoluten URI dar. Weitere Informationen finden Sie unter IsAbsoluteUri.

Hinweise

Weitere Informationen

Gilt für:

Navigate(String, Boolean)

Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) in ein neues Browserfenster oder in das WebBrowser-Steuerelement.

public:
 void Navigate(System::String ^ urlString, bool newWindow);

public void Navigate (string urlString, bool newWindow);

member this.Navigate : string * bool -> unit

Public Sub Navigate (urlString As String, newWindow As Boolean)

Parameter

urlString: String

Die URL des zu ladenden Dokuments.

newWindow: Boolean

true, wenn das Dokument in ein neues Browserfenster geladen werden soll, false, wenn es in das WebBrowser-Steuerelement geladen werden soll.

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.

Hinweise

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 oder eine Seite in ein separates Browserfenster lädt, 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. Wenn eine Seite in ein separates Internet Explorer-Fenster geladen wird, kann der Benutzer die neueste Version abrufen, indem er auf die Schaltfläche Aktualisieren klickt.

Weitere Informationen

Gilt für:

Navigate(String, String)

Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) in das WebBrowser-Steuerelement und ersetzt dabei den Inhalt des Webseitenframes mit dem angegebenen Namen.

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName);

public void Navigate (string urlString, string targetFrameName);

public void Navigate (string urlString, string? targetFrameName);

member this.Navigate : string * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String)

Parameter

urlString: String

Die URL des zu ladenden Dokuments.

targetFrameName: String

Der Name des Frames, in den das Dokument geladen werden soll.

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.

Hinweise

Weitere Informationen

Gilt für:

Navigate(Uri)

Lädt das Dokument, dessen Speicherort vom angegebenen Uri festgelegt wird, in das WebBrowser-Steuerelement und ersetzt dabei das vorherige Dokument.

public:
 void Navigate(Uri ^ url);

public void Navigate (Uri url);

public void Navigate (Uri? url);

member this.Navigate : Uri -> unit

Public Sub Navigate (url As Uri)

Parameter

url: Uri

Ein Uri, der die URL des zu ladenden Dokuments darstellt.

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 Wert des url-Parameters stellt keinen absoluten URI dar. Weitere Informationen finden Sie unter IsAbsoluteUri.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Navigate -Methode 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.

Das vollständige Codebeispiel finden Sie unter Vorgehensweise: Hinzufügen von Webbrowserfunktionen zu einer Windows Forms-Anwendung.

// 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 WebBrowser Steuerelement verwaltet eine Verlaufsliste aller Webseiten, die während einer Browsersitzung besucht wurden. Wenn Sie diese Überladung aufrufen, navigiert das WebBrowser Steuerelement zum angegebenen URI und fügt ihn am Ende der Verlaufsliste hinzu. Verwenden Sie die GoBack -Methode, um das Steuerelement an eine vorherige Seite im Navigationsverlauf zurückzugeben. Verwenden Sie die GoForward -Methode, um zu einer späteren Seite im Navigationsverlauf zurückzukehren, nachdem Sie rückwärts navigiert haben.

Sie können die Navigate -Methode verwenden, um eine Adressleiste ähnlich der in Internet Explorer zu implementieren.

Weitere Informationen

Gilt für:

Navigate(String)

Lädt das Dokument an der angegebenen URL (Uniform Resource Locator) in das WebBrowser-Steuerelement und ersetzt dabei das vorherige Dokument.

public:
 void Navigate(System::String ^ urlString);

public void Navigate (string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

Parameter

urlString: String

Die URL des zu ladenden Dokuments.

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.

Hinweise

Sie können die Navigate -Methode verwenden, um eine Adressleiste ähnlich der in Internet Explorer zu implementieren.

Weitere Informationen

Gilt für:

Teilen über

WebBrowser.Navigate Methode

Definition

Überlädt

Navigate(Uri, String, Byte[], String)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Navigate(String, String, Byte[], String)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Navigate(Uri, Boolean)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Navigate(Uri, String)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Navigate(String, Boolean)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Navigate(String, String)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Navigate(Uri)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Navigate(String)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen