WebBrowser.Navigate Méthode

Définition

Charge le document à l'emplacement spécifié dans le contrôle WebBrowser.Loads the document at the specified location into the WebBrowser control.

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 cadre de la page Web par le nom spécifié.Loads the document at the location indicated by the specified Uri into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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 cadre de la page Web par le nom spécifié.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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.Loads the document at the location indicated by the specified Uri into a new browser window or into the WebBrowser control.

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é.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

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.Loads the document at the specified Uniform Resource Locator (URL) into a new browser window or into the WebBrowser control.

Navigate(String, String)

Charge le document à l'URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser et remplace le contenu du cadre de la page Web par le nom spécifié.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

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.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the previous document.

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.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the previous document.

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 cadre de la page Web par le nom spécifié.Loads the document at the location indicated by the specified Uri into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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);
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.A Uri representing the URL of the document to load.

targetFrameName
String

Nom du frame dans lequel charger le document.The name of the frame in which to load the document.

postData
Byte[]

Données HTTP POST telles que les données de formulaire.HTTP POST data such as form data.

additionalHeaders
String

En-têtes HTTP à ajouter aux en-têtes par défaut.HTTP headers to add to the default headers.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

La valeur du paramètre url ne représente pas d'URI absolu.The url parameter value does not represent an absolute URI. Pour plus d'informations, consultez IsAbsoluteUri.For more information, see IsAbsoluteUri.

Remarques

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le frame de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Si le nom de frame spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Utilisez la GoBack méthode pour retourner le contrôle à une page précédente dans l’historique de navigation.Use the GoBack method to return the control to a previous page in the navigation history. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

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 cadre de la page Web par le nom spécifié.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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);
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.The URL of the document to load.

targetFrameName
String

Nom du frame dans lequel charger le document.The name of the frame in which to load the document.

postData
Byte[]

Données HTTP POST telles que les données de formulaire.HTTP POST data such as form data.

additionalHeaders
String

En-têtes HTTP à ajouter aux en-têtes par défaut.HTTP headers to add to the default headers.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Remarques

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le frame de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Si le nom de frame spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Utilisez la GoBack méthode pour retourner le contrôle à une page précédente dans l’historique de navigation.Use the GoBack method to return the control to a previous page in the navigation history. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

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.Loads the document at the location indicated by the specified Uri into a new browser window or into the WebBrowser control.

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.A Uri representing the URL of the document to load.

newWindow
Boolean

true pour charger le document dans une nouvelle fenêtre de navigateur ; false pour charger le document dans le contrôle WebBrowser.true to load the document into a new browser window; false to load the document into the WebBrowser control.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

La valeur du paramètre url ne représente pas d'URI absolu.The url parameter value does not represent an absolute URI. Pour plus d'informations, consultez IsAbsoluteUri.For more information, see IsAbsoluteUri.

Remarques

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge avec une newWindow valeur de paramètre falsede, le contrôle navigue normalement vers l’URI spécifié et ajoute l’URI à la fin de la liste d’historique.When you call this overload with a newWindow parameter value of false, the control navigates to the specified URI normally and adds the URI to the end of the history list. Quand vous appelez cette surcharge avec une newWindow valeur de paramètre truede, WebBrowser le contrôle charge le document à l’URI spécifié dans une nouvelle fenêtre Internet Explorer, qui gère son propre historique de navigation.When you call this overload with a newWindow parameter value of true, the WebBrowser control loads the document at the specified URI into a new Internet Explorer window, which maintains its own navigation history. Vous pouvez gérer l' NewWindow événement 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.You can handle the NewWindow event to receive notification before a new browser window is opened, allowing you to cancel the action if necessary.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page ou charge une page dans une fenêtre de navigateur distincte, il fait gagner du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page.When the control navigates to a page or loads a page into a separate browser window, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. Quand une page est chargée dans une fenêtre Internet Explorer distincte, l’utilisateur peut récupérer la version la plus récente en **** cliquant sur le bouton Actualiser.When a page is loaded into a separate Internet Explorer window, the user can retrieve the latest version by clicking the Refresh button.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

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é.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

public:
 void Navigate(Uri ^ url, System::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.A Uri representing the URL of the document to load.

targetFrameName
String

Nom du frame dans lequel charger le document.The name of the frame in which to load the document.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

La valeur du paramètre url ne représente pas d'URI absolu.The url parameter value does not represent an absolute URI. Pour plus d'informations, consultez IsAbsoluteUri.For more information, see IsAbsoluteUri.

Remarques

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le frame de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Si le nom de frame spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Utilisez la GoBack méthode pour retourner le contrôle à une page précédente dans l’historique de navigation.Use the GoBack method to return the control to a previous page in the navigation history. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

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.Loads the document at the specified Uniform Resource Locator (URL) into a new browser window or into the WebBrowser control.

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.The URL of the document to load.

newWindow
Boolean

true pour charger le document dans une nouvelle fenêtre de navigateur ; false pour charger le document dans le contrôle WebBrowser.true to load the document into a new browser window; false to load the document into the WebBrowser control.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Remarques

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge avec une newWindow valeur de paramètre falsede, le contrôle navigue normalement vers l’URI spécifié et ajoute l’URI à la fin de la liste d’historique.When you call this overload with a newWindow parameter value of false, the control navigates to the specified URI normally and adds the URI to the end of the history list. Quand vous appelez cette surcharge avec une newWindow valeur de paramètre truede, WebBrowser le contrôle charge le document à l’URI spécifié dans une nouvelle fenêtre Internet Explorer, qui gère son propre historique de navigation.When you call this overload with a newWindow parameter value of true, the WebBrowser control loads the document at the specified URI into a new Internet Explorer window, which maintains its own navigation history. Vous pouvez gérer l' NewWindow événement 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.You can handle the NewWindow event to receive notification before a new browser window is opened, allowing you to cancel the action if necessary.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page ou charge une page dans une fenêtre de navigateur distincte, il fait gagner du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page.When the control navigates to a page or loads a page into a separate browser window, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. Quand une page est chargée dans une fenêtre Internet Explorer distincte, l’utilisateur peut récupérer la version la plus récente en **** cliquant sur le bouton Actualiser.When a page is loaded into a separate Internet Explorer window, the user can retrieve the latest version by clicking the Refresh button.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

Navigate(String, String)

Charge le document à l'URL (Uniform Resource Locator) spécifiée dans le contrôle WebBrowser et remplace le contenu du cadre de la page Web par le nom spécifié.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

public:
 void Navigate(System::String ^ urlString, System::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.The URL of the document to load.

targetFrameName
String

Nom du frame dans lequel charger le document.The name of the frame in which to load the document.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Remarques

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge, le WebBrowser contrôle charge le document à l’URI spécifié dans le frame de la page Web avec le nom spécifié et ajoute l’URI à la fin de la liste d’historique.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Si le nom de frame spécifié n’est pas valide, le document est chargé dans une nouvelle fenêtre Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Utilisez la GoBack méthode pour retourner le contrôle à une page précédente dans l’historique de navigation.Use the GoBack method to return the control to a previous page in the navigation history. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

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.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the previous document.

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.A Uri representing the URL of the document to load.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

La valeur du paramètre url ne représente pas d'URI absolu.The url parameter value does not represent an absolute URI. Pour plus d'informations, consultez IsAbsoluteUri.For more information, see IsAbsoluteUri.

Exemples

L’exemple de code suivant montre comment utiliser la Navigate méthode pour implémenter une barre d’adresses WebBrowser pour le contrôle.The following code example demonstrates how to use the Navigate method to implement an address bar for the WebBrowser control. Cet exemple suppose que votre formulaire contient un WebBrowser contrôle appelé webBrowser1, un TextBox contrôle TextBoxAddressappelé et un Button contrôle appelé ButtonGo.This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. Lorsque vous tapez une URL dans la zone de texte et appuyez sur entrée ou **** cliquez sur le bouton WebBrowser atteindre, le contrôle navigue vers l’URL spécifiée.When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. Lorsque vous naviguez en cliquant sur un lien hypertexte, la zone de texte est automatiquement mise à jour pour afficher l’URL actuelle.When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

Pour obtenir un exemple de code complet , consultez Procédure: Ajoutez des fonctionnalités de navigateur Web à uneapplication Windows Forms.For the complete code example, see 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 gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge, le WebBrowser contrôle navigue vers l’URI spécifié et l’ajoute à la fin de la liste d’historique.When you call this overload, the WebBrowser control navigates to the specified URI and adds it to the end of the history list. Utilisez la GoBack méthode pour retourner le contrôle à une page précédente dans l’historique de navigation.Use the GoBack method to return the control to a previous page in the navigation history. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Vous pouvez utiliser la Navigate méthode pour implémenter une barre d’adresses semblable à celle d’Internet Explorer.You can use the Navigate method to implement an address bar similar to the one in Internet Explorer.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

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.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the previous document.

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.The URL of the document to load.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

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.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Remarques

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quand vous appelez cette surcharge, le WebBrowser contrôle navigue vers l’URI spécifié et l’ajoute à la fin de la liste d’historique.When you call this overload, the WebBrowser control navigates to the specified URI and adds it to the end of the history list. Utilisez la GoBack méthode pour retourner le contrôle à une page précédente dans l’historique de navigation.Use the GoBack method to return the control to a previous page in the navigation history. Utilisez la GoForward méthode pour revenir à une page ultérieure de l’historique de navigation après avoir navigué vers l’arrière.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Vous pouvez utiliser la Navigate méthode pour implémenter une barre d’adresses semblable à celle d’Internet Explorer.You can use the Navigate method to implement an address bar similar to the one in Internet Explorer.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

S’applique à