WebBrowser.Navigate Methode

  • Referenz

Definition

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Navigiert asynchron zu dem Dokument am angegebenen Uri.

Überlädt

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

Navigiert asynchron zu dem Dokument an der angegebenen URL und gibt den Zielframe an, in den der Inhalt des Dokuments geladen werden soll. Weitere HTTP POST-Daten und HTTP-Header können im Rahmen der Navigationsanforderung an den Server gesendet werden.
Navigate(Uri, String, Byte[], String)

Navigiert asynchron zu dem Dokument am angegebenen Uri und gibt den Zielframe an, in den der Inhalt des Dokuments geladen werden soll. Weitere HTTP POST-Daten und HTTP-Header können im Rahmen der Navigationsanforderung an den Server gesendet werden.
Navigate(String)

Navigiert asynchron zu dem Dokument an der angegebenen URL.
Navigate(Uri)

Navigiert asynchron zu dem Dokument am angegebenen Uri.

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

Navigiert asynchron zu dem Dokument an der angegebenen URL und gibt den Zielframe an, in den der Inhalt des Dokuments geladen werden soll. Weitere HTTP POST-Daten und HTTP-Header können im Rahmen der Navigationsanforderung an den Server gesendet werden.

public:
 void Navigate(System::String ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (string source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : string * string * byte[] * string -> unit
Public Sub Navigate (source As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parameter

source
String

Die URL, zu der navigiert werden soll.

targetFrameName
String

Der Name des Frames, in dem der Inhalt des Dokuments angezeigt werden soll.

postData
Byte[]

HTTP-POST-Daten, die beim Anfordern der Quelle an den Server gesendet werden sollen.

additionalHeaders
String

HTTP-Header, die beim Anfordern der Quelle an den Server gesendet werden sollen.

Hinweise

Verwenden Sie die Navigate(String, String, Byte[], String) Methode, um zu einer URL zu navigieren, die Escapezeichen enthalten kann. Verwenden Sie die Methode, um zu einer Uri zu navigieren, die Navigate(Uri, String, Byte[], String) keine Escapezeichen enthält.

Gilt für

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

Navigiert asynchron zu dem Dokument am angegebenen Uri und gibt den Zielframe an, in den der Inhalt des Dokuments geladen werden soll. Weitere HTTP POST-Daten und HTTP-Header können im Rahmen der Navigationsanforderung an den Server gesendet werden.

public:
 void Navigate(Uri ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (Uri source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : Uri * string * byte[] * string -> unit
Public Sub Navigate (source As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parameter

source
Uri

Der Uri, zu dem navigiert werden soll.

targetFrameName
String

Der Name des Frames, in dem der Inhalt des Dokuments angezeigt werden soll.

postData
Byte[]

HTTP-POST-Daten, die beim Anfordern der Quelle an den Server gesendet werden sollen.

additionalHeaders
String

HTTP-Header, die beim Anfordern der Quelle an den Server gesendet werden sollen.

Ausnahmen

ObjectDisposedException

Die WebBrowser-Instanz ist nicht mehr gültig.

InvalidOperationException

Ein Verweis auf den zugrunde liegenden nativen WebBrowser konnte nicht abgerufen werden.

SecurityException

Navigation aus einer Anwendung, die mit teilweiser Vertrauenswürdigkeit ausgeführt wird: – Zu einem Uri, der sich nicht auf der Ursprungssite befindet oder

  • targetFrameName-Name ist nicht null oder leer.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie zu einem Dokument navigieren und es in einem neuen Browserfenster öffnen, indem Sie das Ziel "about:leer" angeben.

<StackPanel>  
    <StackPanel Orientation="Horizontal">  
        <TextBox x:Name="addressTextBox" Width="200" />  
        <Button Click="goNavigateButton_Click">Go</Button>  
    </StackPanel>  
    <WebBrowser x:Name="myWebBrowser" />  
</StackPanel>  

private void goNavigateButton_Click(object sender, RoutedEventArgs e)  
{  
    // Get URI to navigate to  
    Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);  

    // Only absolute URIs can be navigated to  
    if (!uri.IsAbsoluteUri)  
    {  
        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
        return;  
    }  

    // Navigate to the desired URL by calling the .Navigate method  
    this.myWebBrowser.Navigate(uri, "_blank", null, null);  
}

Hinweise

Verwenden Sie die Navigate(String, String, Byte[], String) Methode, um zu einer URL zu navigieren, die Escapezeichen enthalten kann. Verwenden Sie die Methode, um zu einer Uri zu navigieren, die Navigate(Uri, String, Byte[], String) keine Escapezeichen enthält.

Gilt für

Navigate(String)

Navigiert asynchron zu dem Dokument an der angegebenen URL.

public:
 void Navigate(System::String ^ source);
public void Navigate (string source);
member this.Navigate : string -> unit
Public Sub Navigate (source As String)

Parameter

source
String

Die URL, zu der navigiert werden soll.

Hinweise

Verwenden Sie die Navigate(String) Methode, um zu einer URL zu navigieren, die Escapezeichen enthalten kann. Verwenden Sie die Methode, um zu einer Uri zu navigieren, die Navigate(Uri) keine Escapezeichen enthält.

Gilt für

Navigate(Uri)

Navigiert asynchron zu dem Dokument am angegebenen Uri.

public:
 void Navigate(Uri ^ source);
public void Navigate (Uri source);
member this.Navigate : Uri -> unit
Public Sub Navigate (source As Uri)

Parameter

source
Uri

Der Uri, zu dem navigiert werden soll.

Ausnahmen

ObjectDisposedException

Die WebBrowser-Instanz ist nicht mehr gültig.

InvalidOperationException

Ein Verweis auf den zugrunde liegenden nativen WebBrowser konnte nicht abgerufen werden.

SecurityException

Navigation aus einer Anwendung, die mit teilweiser Vertrauenswürdigkeit ausgeführt wird, zu einem Uri, der sich nicht auf der Ursprungssite befindet.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie WebBrowser mithilfe der Navigate(Uri) Methode zu einem Dokument navigieren.

<StackPanel>  
    <StackPanel Orientation="Horizontal">  
        <TextBox x:Name="addressTextBox" Width="200" />  
        <Button Click="goNavigateButton_Click">Go</Button>  
    </StackPanel>  
    <WebBrowser x:Name="myWebBrowser" />  
</StackPanel>  

private void goNavigateButton_Click(object sender, RoutedEventArgs e)  
{  
    // Get URI to navigate to  
    Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);  

    // Only absolute URIs can be navigated to  
    if (!uri.IsAbsoluteUri)  
    {  
        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
        return;  
    }  

    // Navigate to the desired URL by calling the .Navigate method  
    this.myWebBrowser.Navigate(uri);  
}

Hinweise

Das Aufrufen Navigate(Uri) hat den gleichen Effekt wie das Festlegen der Source Eigenschaft. Source wird aus Markup von Entwicklern verwendet, die deklarativ das anfängliche Dokument angeben möchten, zu WebBrowser dem navigieren, wann WebBrowser initialisiert wird.

Verwenden Sie die Navigate(String) Methode, um zu einer URL zu navigieren, die Escapezeichen enthalten kann. Verwenden Sie die Methode, um zu einer Uri zu navigieren, die Navigate(Uri) keine Escapezeichen enthält.

Gilt für