WebBrowser.Navigate Methode

Definitie

Naamruimte:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Navigeer asynchroon naar het document op de opgegeven Uri.

Overloads

Name	Description
Navigate(String, String, Byte[], String)	Navigeert asynchroon naar het document op de opgegeven URL en geeft het doelframe op waarin de inhoud van het document moet worden geladen. Aanvullende HTTP POST-gegevens en HTTP-headers kunnen als onderdeel van de navigatieaanvraag naar de server worden verzonden.
Navigate(Uri, String, Byte[], String)	Navigeer asynchroon naar het document op het opgegeven Uri document en geef het doelframe op waarin de inhoud van het document moet worden geladen. Aanvullende HTTP POST-gegevens en HTTP-headers kunnen als onderdeel van de navigatieaanvraag naar de server worden verzonden.
Navigate(String)	Navigeert asynchroon naar het document op de opgegeven URL.
Navigate(Uri)	Navigeer asynchroon naar het document op de opgegeven Uri.

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

Navigeert asynchroon naar het document op de opgegeven URL en geeft het doelframe op waarin de inhoud van het document moet worden geladen. Aanvullende HTTP POST-gegevens en HTTP-headers kunnen als onderdeel van de navigatieaanvraag naar de server worden verzonden.

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)

Parameters

source: String

De URL waarnaar u wilt navigeren.

targetFrameName: String

De naam van het frame waarin de inhoud van het document wordt weergegeven.

postData: Byte[]

HTTP POST-gegevens die naar de server moeten worden verzonden wanneer de bron wordt aangevraagd.

additionalHeaders: String

HTTP-headers die naar de server moeten worden verzonden wanneer de bron wordt aangevraagd.

Opmerkingen

Gebruik de Navigate(String, String, Byte[], String) methode om naar een URL te navigeren die escape-tekens kan bevatten. Gebruik de Navigate(Uri, String, Byte[], String) methode om te navigeren naar een escape-teken Uri dat geen escapetekens bevat.

Van toepassing op

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

Navigeer asynchroon naar het document op het opgegeven Uri document en geef het doelframe op waarin de inhoud van het document moet worden geladen. Aanvullende HTTP POST-gegevens en HTTP-headers kunnen als onderdeel van de navigatieaanvraag naar de server worden verzonden.

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)

Parameters

source: Uri

De Uri om naar te navigeren.

targetFrameName: String

De naam van het frame waarin de inhoud van het document wordt weergegeven.

postData: Byte[]

HTTP POST-gegevens die naar de server moeten worden verzonden wanneer de bron wordt aangevraagd.

additionalHeaders: String

HTTP-headers die naar de server moeten worden verzonden wanneer de bron wordt aangevraagd.

Uitzonderingen

ObjectDisposedException

Het WebBrowser exemplaar is niet meer geldig.

InvalidOperationException

Een verwijzing naar de onderliggende systeemeigen WebBrowser kan niet worden opgehaald.

SecurityException

Navigatie vanuit een toepassing die wordt uitgevoerd in gedeeltelijke vertrouwensrelatie:

Naar een Uri die zich niet op de locatie van oorsprong bevindt, of
targetFrameName naam is niet null of leeg.

Voorbeelden

In het volgende voorbeeld ziet u hoe u naar een document navigeert en opent in een nieuw browservenster door het doel about:blank op te geven.

<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);
}

Opmerkingen

Van toepassing op

Navigate(String)

Navigeert asynchroon naar het document op de opgegeven URL.

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

public void Navigate(string source);

member this.Navigate : string -> unit

Public Sub Navigate (source As String)

Parameters

source: String

De URL waarnaar u wilt navigeren.

Opmerkingen

Gebruik de Navigate(String) methode om naar een URL te navigeren die escape-tekens kan bevatten. Gebruik de Navigate(Uri) methode om te navigeren naar een escape-teken Uri dat geen escapetekens bevat.

Van toepassing op

Navigate(Uri)

Navigeer asynchroon naar het document op de opgegeven Uri.

public:
 void Navigate(Uri ^ source);

public void Navigate(Uri source);

member this.Navigate : Uri -> unit

Public Sub Navigate (source As Uri)

Parameters

source: Uri

De Uri om naar te navigeren.

Uitzonderingen

ObjectDisposedException

Het WebBrowser exemplaar is niet meer geldig.

InvalidOperationException

Een verwijzing naar de onderliggende systeemeigen WebBrowser kan niet worden opgehaald.

SecurityException

Navigatie vanuit een toepassing die gedeeltelijk wordt vertrouwd met een Uri toepassing die zich niet op de locatie van oorsprong bevindt.

Voorbeelden

In het volgende voorbeeld ziet u hoe WebBrowser u met behulp van de Navigate(Uri) methode naar een document navigeert.

<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);
}

Opmerkingen

Het aanroepen Navigate(Uri) heeft hetzelfde effect als het instellen van de Source eigenschap. Source wordt gebruikt vanuit markeringen door ontwikkelaars die declaratief het oorspronkelijke document willen opgeven waarnaar WebBrowser wordt genavigeerd wanneer WebBrowser deze wordt geïnitialiseerd.

Van toepassing op

Feedback

Is deze pagina nuttig?