WebBrowser.Navigate Méthode

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.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.

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

Surcharges

Nom	Description
Navigate(Uri, String, Byte[], String)	Charge le document à l’emplacement indiqué par le Uri contrôle spécifiéWebBrowser, en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du cadre de page Web par le nom spécifié.
Navigate(String, String, Byte[], String)	Charge le document au niveau de l’URL (Uniform Resource Locator) spécifié dans le WebBrowser contrôle, en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du cadre de page Web par le nom spécifié.
Navigate(Uri, Boolean)	Charge le document à l’emplacement indiqué par le spécifié Uri dans une nouvelle fenêtre de navigateur ou dans le WebBrowser contrôle.
Navigate(Uri, String)	Charge le document à l’emplacement indiqué par le Uri contrôle spécifiéWebBrowser, en remplaçant le contenu du cadre de page Web par le nom spécifié.
Navigate(String, Boolean)	Charge le document à l’URL (Uniform Resource Locator) spécifié dans une nouvelle fenêtre de navigateur ou dans le WebBrowser contrôle.
Navigate(String, String)	Charge le document au niveau de l’URL (Uniform Resource Locator) spécifié dans le WebBrowser contrôle, en remplaçant le contenu du cadre de page Web par le nom spécifié.
Navigate(Uri)	Charge le document à l’emplacement indiqué par le Uri contrôle spécifiéWebBrowser, en remplaçant le document précédent.
Navigate(String)	Charge le document au niveau de l’URL (Uniform Resource Locator) spécifié dans le WebBrowser contrôle, en remplaçant le document précédent.

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

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Charge le document à l’emplacement indiqué par le Uri contrôle spécifiéWebBrowser, en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du cadre de 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

Représentant Uri l’URL du document à charger.

targetFrameName: String

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

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

ArgumentException

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

Remarques

Le WebBrowser contrôle conserve une liste d’historiques 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’historiques. Si le nom de frame 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 dans l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure dans l’historique de navigation après avoir navigué vers l’arrière.

Le WebBrowser contrôle stocke les pages Web à partir de 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, si celle-ci est disponible, 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 veillant à ce que le contrôle affiche la dernière version.

Voir aussi

S’applique à

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

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Charge le document au niveau de l’URL (Uniform Resource Locator) spécifié dans le WebBrowser contrôle, en le demandant à l’aide des données HTTP spécifiées et en remplaçant le contenu du cadre de 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 cadre 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 WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

Remarques

Voir aussi

S’applique à

Navigate(Uri, Boolean)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

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

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

Représentant Uri 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 WebBrowser contrôle.

Exceptions

ObjectDisposedException

Cette WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

ArgumentException

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

Remarques

Le WebBrowser contrôle conserve une liste d’historiques de toutes les pages Web visitées pendant une session de navigation. Lorsque vous appelez cette surcharge avec une newWindow valeur de paramètre, falsele contrôle accède normalement à l’URI spécifié et ajoute l’URI à la fin de la liste d’historiques. Lorsque vous appelez cette surcharge avec une valeur de paramètre newWindow de true, le contrôle WebBrowser charge le document à l’URI spécifié dans une nouvelle fenêtre de Internet Explorer, qui conserve son propre historique de navigation. Vous pouvez gérer l’événement pour recevoir une NewWindow 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 à partir de 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, si celle-ci est disponible, 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 veillant à ce que le contrôle affiche la dernière version. Lorsqu’une page est chargée dans une fenêtre de Internet Explorer distincte, l’utilisateur peut récupérer la dernière version en cliquant sur le bouton Refresh.

Voir aussi

S’applique à

Navigate(Uri, String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Charge le document à l’emplacement indiqué par le Uri contrôle spécifiéWebBrowser, en remplaçant le contenu du cadre de 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

Représentant Uri l’URL du document à charger.

targetFrameName: String

Nom du cadre dans lequel charger le document.

Exceptions

ObjectDisposedException

Cette WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

ArgumentException

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

Remarques

Voir aussi

S’applique à

Navigate(String, Boolean)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

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

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 WebBrowser contrôle.

Exceptions

ObjectDisposedException

Cette WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

Remarques

Le WebBrowser contrôle stocke les pages Web à partir de 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, si celle-ci est disponible, 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 veillant à ce que le contrôle affiche la dernière version. Lorsqu’une page est chargée dans une fenêtre de Internet Explorer distincte, l’utilisateur peut récupérer la dernière version en cliquant sur le bouton Refresh.

Voir aussi

S’applique à

Navigate(String, String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Charge le document au niveau de l’URL (Uniform Resource Locator) spécifié dans le WebBrowser contrôle, en remplaçant le contenu du cadre de 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 cadre dans lequel charger le document.

Exceptions

ObjectDisposedException

Cette WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

Remarques

Voir aussi

S’applique à

Navigate(Uri)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Charge le document à l’emplacement indiqué par le Uri contrôle spécifié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

Représentant Uri l’URL du document à charger.

Exceptions

ObjectDisposedException

Cette WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

ArgumentException

La valeur du url paramètre 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’adresses 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 appuyez sur Entrée ou cliquez sur le bouton Go , 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 How to : Add Web Browser Capabilities to a Windows Forms Application.

// 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’historiques 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’historiques. Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente dans l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure dans l’historique de navigation après avoir navigué vers l’arrière.

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

Voir aussi

S’applique à

Navigate(String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Charge le document au niveau de l’URL (Uniform Resource Locator) spécifié dans le WebBrowser contrôle, en remplaçant 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 WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

Remarques

Le WebBrowser contrôle conserve une liste d’historiques 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’historiques. Utilisez la GoBack méthode pour renvoyer le contrôle à une page précédente dans l’historique de navigation. Utilisez la GoForward méthode pour revenir à une page ultérieure dans l’historique de navigation après avoir navigué vers l’arrière.

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

Voir aussi

S’applique à

Commentaires

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