Partager via

WebBrowser.Navigate Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Charge le document à l'emplacement spécifié dans le contrôle WebBrowser.

Surcharges

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

Charge le document à l’emplacement indiqué par le Uri spécifié dans le contrôle WebBrowser en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du frame de la page web par le nom spécifié.
Navigate(String, String, Byte[], String)

Charge le document à l’URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du frame de la page web par le nom spécifié.
Navigate(Uri, Boolean)

Charge le document à l'emplacement indiqué par le Uri spécifié dans une nouvelle fenêtre de navigateur ou dans le contrôle WebBrowser.
Navigate(Uri, String)

Charge le document à l'emplacement indiqué par le Uri spécifié dans le contrôle WebBrowser et remplace le contenu du cadre de la page web par le nom spécifié.
Navigate(String, Boolean)

Charge le document à l'URL (Uniform Resource Locator) spécifiée dans une nouvelle fenêtre de navigateur ou dans le contrôle WebBrowser.
Navigate(String, String)

Charge le document à l’URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser et remplace le contenu du frame de la page web par le nom spécifié.
Navigate(Uri)

Charge le document à l'emplacement indiqué par le Uri spécifié dans le contrôle WebBrowser en remplaçant le document précédent.
Navigate(String)

Charge le document à l'URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser et remplace le document précédent.

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

Charge le document à l’emplacement indiqué par le Uri spécifié dans le contrôle WebBrowser en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du frame de la page web par le nom spécifié.

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)

Paramètres

url
Uri

Uri représentant l'URL du document à charger.

targetFrameName
String

Nom du frame dans lequel charger le document.

postData
Byte[]

Données HTTP POST telles que les données de formulaire.

additionalHeaders
String

En-têtes HTTP à ajouter aux en-têtes par défaut.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

ArgumentException

La valeur du paramètre url ne représente pas d'URI absolu. Pour plus d'informations, consultez IsAbsoluteUri.

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le cadre de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique. Si le nom du cadre spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.

Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente de l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version.

Voir aussi

S’applique à

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

Charge le document à l’URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du frame de la page web par le nom spécifié.

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)

Paramètres

urlString
String

URL du document à charger.

targetFrameName
String

Nom du frame dans lequel charger le document.

postData
Byte[]

Données HTTP POST telles que les données de formulaire.

additionalHeaders
String

En-têtes HTTP à ajouter aux en-têtes par défaut.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le cadre de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique. Si le nom du cadre spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.

Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente de l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version.

Voir aussi

S’applique à

Navigate(Uri, Boolean)

Charge le document à l'emplacement indiqué par le Uri spécifié dans une nouvelle fenêtre de navigateur ou dans le contrôle WebBrowser.

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)

Paramètres

url
Uri

Uri représentant l'URL du document à charger.

newWindow
Boolean

true pour charger le document dans une nouvelle fenêtre de navigateur ; false pour charger le document dans le contrôle WebBrowser.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

ArgumentException

La valeur du paramètre url ne représente pas d'URI absolu. Pour plus d'informations, consultez IsAbsoluteUri.

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge avec la newWindow valeur de falseparamètre , le contrôle accède normalement à l’URI spécifié et ajoute l’URI à la fin de la liste d’historique. Lorsque vous appelez cette surcharge avec une newWindow valeur de trueparamètre , le WebBrowser contrôle charge le document à l’URI spécifié dans une nouvelle fenêtre Internet Explorer, qui conserve son propre historique de navigation. Vous pouvez gérer l’événement NewWindow pour recevoir une notification avant l’ouverture d’une nouvelle fenêtre de navigateur, ce qui vous permet d’annuler l’action si nécessaire.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page ou charge une page dans une fenêtre de navigateur distincte, il gagne du temps en affichant une version mise en cache, le cas échéant, plutôt que de la télécharger à nouveau. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version. Lorsqu’une page est chargée dans une fenêtre Internet Explorer distincte, l’utilisateur peut récupérer la dernière version en cliquant sur le bouton Actualiser .

Voir aussi

S’applique à

Navigate(Uri, String)

Charge le document à l'emplacement indiqué par le Uri spécifié dans le contrôle WebBrowser et remplace le contenu du cadre de la page web par le nom spécifié.

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)

Paramètres

url
Uri

Uri représentant l'URL du document à charger.

targetFrameName
String

Nom du frame dans lequel charger le document.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

ArgumentException

La valeur du paramètre url ne représente pas d'URI absolu. Pour plus d'informations, consultez IsAbsoluteUri.

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le cadre de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique. Si le nom du cadre spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.

Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente de l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version.

Voir aussi

S’applique à

Navigate(String, Boolean)

Charge le document à l'URL (Uniform Resource Locator) spécifiée dans une nouvelle fenêtre de navigateur ou dans le contrôle WebBrowser.

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)

Paramètres

urlString
String

URL du document à charger.

newWindow
Boolean

true pour charger le document dans une nouvelle fenêtre de navigateur ; false pour charger le document dans le contrôle WebBrowser.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge avec la newWindow valeur de falseparamètre , le contrôle accède normalement à l’URI spécifié et ajoute l’URI à la fin de la liste d’historique. Lorsque vous appelez cette surcharge avec une newWindow valeur de trueparamètre , le WebBrowser contrôle charge le document à l’URI spécifié dans une nouvelle fenêtre Internet Explorer, qui conserve son propre historique de navigation. Vous pouvez gérer l’événement NewWindow pour recevoir une notification avant l’ouverture d’une nouvelle fenêtre de navigateur, ce qui vous permet d’annuler l’action si nécessaire.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page ou charge une page dans une fenêtre de navigateur distincte, il gagne du temps en affichant une version mise en cache, le cas échéant, plutôt que de la télécharger à nouveau. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version. Lorsqu’une page est chargée dans une fenêtre Internet Explorer distincte, l’utilisateur peut récupérer la dernière version en cliquant sur le bouton Actualiser .

Voir aussi

S’applique à

Navigate(String, String)

Charge le document à l’URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser et remplace le contenu du frame de la page web par le nom spécifié.

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)

Paramètres

urlString
String

URL du document à charger.

targetFrameName
String

Nom du frame dans lequel charger le document.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le cadre de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique. Si le nom du cadre spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.

Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente de l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version.

Voir aussi

S’applique à

Navigate(Uri)

Charge le document à l'emplacement indiqué par le Uri spécifié dans le contrôle WebBrowser en remplaçant le document précédent.

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)

Paramètres

url
Uri

Uri représentant l'URL du document à charger.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

ArgumentException

La valeur du paramètre url ne représente pas d'URI absolu. Pour plus d'informations, consultez IsAbsoluteUri.

Exemples

L’exemple de code suivant montre comment utiliser la Navigate méthode pour implémenter une barre d’adresse pour le WebBrowser contrôle. Cet exemple nécessite que votre formulaire contienne un WebBrowser contrôle appelé webBrowser1, un TextBox contrôle appelé TextBoxAddresset un Button contrôle appelé ButtonGo. Lorsque vous tapez une URL dans la zone de texte et que vous appuyez sur ENTRÉE ou cliquez sur le bouton Atteindre , le WebBrowser contrôle accède à l’URL spécifiée. Lorsque vous naviguez en cliquant sur un lien hypertexte, la zone de texte est automatiquement mise à jour pour afficher l’URL actuelle.

Pour obtenir l’exemple de code complet, consultez Guide pratique pour ajouter des fonctionnalités de navigateur web à une application Windows Forms.

// 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

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge, le WebBrowser contrôle accède à l’URI spécifié et l’ajoute à la fin de la liste d’historique. Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente de l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version.

Vous pouvez utiliser la Navigate méthode pour implémenter une barre d’adresses similaire à celle d’Internet Explorer.

Voir aussi

S’applique à

Navigate(String)

Charge le document à l'URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser et remplace le document précédent.

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

Paramètres

urlString
String

URL du document à charger.

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge, le WebBrowser contrôle accède à l’URI spécifié et l’ajoute à la fin de la liste d’historique. Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente de l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version.

Vous pouvez utiliser la Navigate méthode pour implémenter une barre d’adresses similaire à celle d’Internet Explorer.

Voir aussi

S’applique à