WebBrowser.Navigate Méthode

Définition

Espace de noms:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Accédez de manière asynchrone au document au niveau spécifié Uri.

Surcharges

Nom	Description
Navigate(String, String, Byte[], String)	Navigue de manière asynchrone vers le document à l’URL spécifiée et spécifie le cadre cible dans lequel charger le contenu du document. Des données HTTP POST supplémentaires et des en-têtes HTTP peuvent être envoyés au serveur dans le cadre de la demande de navigation.
Navigate(Uri, String, Byte[], String)	Accédez de manière asynchrone au document au niveau spécifié Uri et spécifiez le cadre cible dans lequel charger le contenu du document. Des données HTTP POST supplémentaires et des en-têtes HTTP peuvent être envoyés au serveur dans le cadre de la demande de navigation.
Navigate(String)	Navigue de manière asynchrone vers le document à l’URL spécifiée.
Navigate(Uri)	Accédez de manière asynchrone au document au niveau spécifié Uri.

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

Navigue de manière asynchrone vers le document à l’URL spécifiée et spécifie le cadre cible dans lequel charger le contenu du document. Des données HTTP POST supplémentaires et des en-têtes HTTP peuvent être envoyés au serveur dans le cadre de la demande de navigation.

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)

Paramètres

source: String

URL à laquelle accéder.

targetFrameName: String

Nom du cadre dans lequel afficher le contenu du document.

postData: Byte[]

Données HTTP POST à envoyer au serveur lorsque la source est demandée.

additionalHeaders: String

En-têtes HTTP à envoyer au serveur lorsque la source est demandée.

Remarques

Utilisez la Navigate(String, String, Byte[], String) méthode pour accéder à une URL qui peut inclure des caractères d’échappement. Utilisez la Navigate(Uri, String, Byte[], String) méthode pour accéder à un Uri caractère d’échappement qui n’inclut pas les caractères d’échappement.

S’applique à

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

Accédez de manière asynchrone au document au niveau spécifié Uri et spécifiez le cadre cible dans lequel charger le contenu du document. Des données HTTP POST supplémentaires et des en-têtes HTTP peuvent être envoyés au serveur dans le cadre de la demande de navigation.

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)

Paramètres

source: Uri

À Uri accéder.

targetFrameName: String

Nom du cadre dans lequel afficher le contenu du document.

postData: Byte[]

Données HTTP POST à envoyer au serveur lorsque la source est demandée.

additionalHeaders: String

En-têtes HTTP à envoyer au serveur lorsque la source est demandée.

Exceptions

ObjectDisposedException

L’instance WebBrowser n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence au natif WebBrowser sous-jacent.

SecurityException

Navigation à partir d’une application qui s’exécute en confiance partielle :

À un Uri emplacement qui n’est pas situé sur le site d’origine, ou
targetFrameName nom n’est pas null ou vide.

Exemples

L’exemple suivant montre comment accéder à un document et l’ouvrir dans une nouvelle fenêtre de navigateur en spécifiant la cible « about :blank ».

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

Remarques

S’applique à

Navigate(String)

Navigue de manière asynchrone vers le document à l’URL spécifiée.

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

public void Navigate(string source);

member this.Navigate : string -> unit

Public Sub Navigate (source As String)

Paramètres

source: String

URL à laquelle accéder.

Remarques

Utilisez la Navigate(String) méthode pour accéder à une URL qui peut inclure des caractères d’échappement. Utilisez la Navigate(Uri) méthode pour accéder à un Uri caractère d’échappement qui n’inclut pas les caractères d’échappement.

S’applique à

Navigate(Uri)

Accédez de manière asynchrone au document au niveau spécifié Uri.

public:
 void Navigate(Uri ^ source);

public void Navigate(Uri source);

member this.Navigate : Uri -> unit

Public Sub Navigate (source As Uri)

Paramètres

source: Uri

À Uri accéder.

Exceptions

ObjectDisposedException

L’instance WebBrowser n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence au natif WebBrowser sous-jacent.

SecurityException

Navigation à partir d’une application qui s’exécute en confiance partielle vers un Uri emplacement qui n’est pas situé sur le site d’origine.

Exemples

L’exemple suivant montre comment utiliser WebBrowser pour accéder à un document à l’aide de la Navigate(Uri) méthode.

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

Remarques

L’appel Navigate(Uri) a le même effet que la définition de la Source propriété. Source est utilisé à partir du balisage par les développeurs qui souhaitent spécifier de manière déclarative le document initial qui WebBrowser accède au moment WebBrowser de l’initialisation.

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

WebBrowser.Navigate Méthode

Définition

Surcharges

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

Paramètres

Remarques

S’applique à

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

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Navigate(String)

Paramètres

Remarques

S’applique à

Navigate(Uri)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Commentaires