WebBrowser.Navigate Méthode

Référence

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.

Naviguez de façon asynchrone vers le document situé au Uri spécifié.

Surcharges

Navigate(String, String, Byte[], String)	Navigue de façon asynchrone jusqu'au document situé au niveau de l'URL spécifiée et spécifie le frame cible dans lequel le contenu du document doit être chargé. Des données HTTP POST et des en-têtes HTTP supplémentaires peuvent être envoyés au serveur dans le cadre de la demande de navigation.
Navigate(Uri, String, Byte[], String)	Naviguez de façon asynchrone vers le document au Uri spécifié et spécifiez le frame cible dans lequel charger le contenu du document. Des données HTTP POST et des en-têtes HTTP supplémentaires peuvent être envoyés au serveur dans le cadre de la demande de navigation.
Navigate(String)	Navigue de façon asynchrone jusqu'au document situé au niveau de l'URL spécifiée.
Navigate(Uri)	Naviguez de façon asynchrone vers le document situé au Uri spécifié.

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

Navigue de façon asynchrone jusqu'au document situé au niveau de l'URL spécifiée et spécifie le frame cible dans lequel le contenu du document doit être chargé. Des données HTTP POST et des en-têtes HTTP supplémentaires 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 à atteindre.

targetFrameName: String

Nom du frame 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 de caractères d’échappement.

S’applique à

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

Naviguez de façon asynchrone vers le document au Uri spécifié et spécifiez le frame cible dans lequel charger le contenu du document. Des données HTTP POST et des en-têtes HTTP supplémentaires 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 vers lequel naviguer.

targetFrameName: String

Nom du frame 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 de WebBrowser n’est plus valide.

InvalidOperationException

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

SecurityException

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

Vers Uri qui ne se trouve pas sur le site d’origine, ou
Le nom targetFrameName n’est ni null ni 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 façon asynchrone jusqu'au document situé au niveau de 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 à atteindre.

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 de caractères d’échappement.

S’applique à

Navigate(Uri)

Naviguez de façon asynchrone vers le document situé au Uri spécifié.

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 vers lequel naviguer.

Exceptions

ObjectDisposedException

L’instance de WebBrowser n’est plus valide.

InvalidOperationException

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

SecurityException

Navigation à partir d'une application qui s'exécute en confiance partielle vers Uri qui ne se trouve pas dans 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 à

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 à

Ressources supplémentaires