WebBrowser.Navigate Método

Definición

Carga el documento en la ubicación especificada en el control WebBrowser.Loads the document at the specified location into the WebBrowser control.

Sobrecargas

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

Carga el documento de la ubicación indicada por el Uri especificado en el control WebBrowser y solicita que use los datos HTTP especificados y que reemplace el contenido del marco de la página web por el nombre especificado.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)

Carga el documento del Localizador uniforme de recursos (URL) especificado en el control WebBrowser y solicita que use los datos HTTP especificados y que reemplace el contenido del marco de la página web por el nombre especificado.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)

Carga el documento de la ubicación indicada por el Uri especificado en una nueva ventana del explorador o en el control 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)

Carga el documento de la ubicación indicada por el Uri especificado en el control WebBrowser y reemplaza el contenido del marco de la página web por el nombre especificado.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)

Carga el documento del Localizador uniforme de recursos (URL) especificado en una nueva ventana del explorador o en el control WebBrowser.Loads the document at the specified Uniform Resource Locator (URL) into a new browser window or into the WebBrowser control.

Navigate(String, String)

Carga el documento del Localizador uniforme de recursos (URL) especificado en el control WebBrowser y reemplaza el contenido del marco de la página web por el nombre especificado.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)

Carga el documento en la ubicación indicada por el Uri especificado en el control WebBrowser y reemplaza el documento anterior.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the previous document.

Navigate(String)

Carga el documento del Localizador uniforme de recursos (URL) especificado en el control WebBrowser y reemplaza el documento anterior.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the previous document.

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

Carga el documento de la ubicación indicada por el Uri especificado en el control WebBrowser y solicita que use los datos HTTP especificados y que reemplace el contenido del marco de la página web por el nombre especificado.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)

Parámetros

url
Uri

Uri que representa la dirección URL del documento que se va a cargar.A Uri representing the URL of the document to load.

targetFrameName
String

Nombre del marco en el que se carga el documento.The name of the frame in which to load the document.

postData
Byte[]

Datos de HTTP POST, como los datos del formulario.HTTP POST data such as form data.

additionalHeaders
String

Encabezados de HTTP para agregar a los encabezados predeterminados.HTTP headers to add to the default headers.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

El valor de parámetro url no representa un URI absoluto.The url parameter value does not represent an absolute URI. Para obtener más información, vea IsAbsoluteUri.For more information, see IsAbsoluteUri.

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de la página web con el nombre especificado y agrega el URI al final de la lista del historial.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 el nombre del marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Use el GoBack método para devolver el control a una página anterior del historial de navegación.Use the GoBack method to return the control to a previous page in the navigation history. Use el GoForward método para volver a una página posterior del historial de navegación después de desplazarse hacia atrás.Use the GoForward method to return to a later page in the navigation history after navigating backward.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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.

Consulte también

Se aplica a

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

Carga el documento del Localizador uniforme de recursos (URL) especificado en el control WebBrowser y solicita que use los datos HTTP especificados y que reemplace el contenido del marco de la página web por el nombre especificado.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)

Parámetros

urlString
String

Dirección URL del documento que se va a cargar.The URL of the document to load.

targetFrameName
String

Nombre del marco en el que se carga el documento.The name of the frame in which to load the document.

postData
Byte[]

Datos de HTTP POST, como los datos del formulario.HTTP POST data such as form data.

additionalHeaders
String

Encabezados de HTTP para agregar a los encabezados predeterminados.HTTP headers to add to the default headers.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de la página web con el nombre especificado y agrega el URI al final de la lista del historial.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 el nombre del marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Use el GoBack método para devolver el control a una página anterior del historial de navegación.Use the GoBack method to return the control to a previous page in the navigation history. Use el GoForward método para volver a una página posterior del historial de navegación después de desplazarse hacia atrás.Use the GoForward method to return to a later page in the navigation history after navigating backward.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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.

Consulte también

Se aplica a

Navigate(Uri, Boolean)

Carga el documento de la ubicación indicada por el Uri especificado en una nueva ventana del explorador o en el control 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)

Parámetros

url
Uri

Uri que representa la dirección URL del documento que se va a cargar.A Uri representing the URL of the document to load.

newWindow
Boolean

Es true para cargar el documento en una nueva ventana del explorador; es false para cargar el documento en el control WebBrowser.true to load the document into a new browser window; false to load the document into the WebBrowser control.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

El valor de parámetro url no representa un URI absoluto.The url parameter value does not represent an absolute URI. Para obtener más información, vea IsAbsoluteUri.For more information, see IsAbsoluteUri.

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de false , el control navega al URI especificado con normalidad y agrega el URI al final de la lista de historial.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. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de true , el WebBrowser control carga el documento en el URI especificado en una nueva ventana de Internet Explorer, que mantiene su propio historial de navegación.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. Puede controlar el NewWindow evento para recibir notificaciones antes de que se abra una nueva ventana del explorador, lo que le permite cancelar la acción si es necesario.You can handle the NewWindow event to receive notification before a new browser window is opened, allowing you to cancel the action if necessary.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página o carga una página en una ventana del explorador independiente, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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. Cuando se carga una página en una ventana independiente de Internet Explorer, el usuario puede recuperar la versión más reciente haciendo clic en el botón Actualizar .When a page is loaded into a separate Internet Explorer window, the user can retrieve the latest version by clicking the Refresh button.

Consulte también

Se aplica a

Navigate(Uri, String)

Carga el documento de la ubicación indicada por el Uri especificado en el control WebBrowser y reemplaza el contenido del marco de la página web por el nombre especificado.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)

Parámetros

url
Uri

Uri que representa la dirección URL del documento que se va a cargar.A Uri representing the URL of the document to load.

targetFrameName
String

Nombre del marco en el que se carga el documento.The name of the frame in which to load the document.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

El valor de parámetro url no representa un URI absoluto.The url parameter value does not represent an absolute URI. Para obtener más información, vea IsAbsoluteUri.For more information, see IsAbsoluteUri.

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de la página web con el nombre especificado y agrega el URI al final de la lista del historial.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 el nombre del marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Use el GoBack método para devolver el control a una página anterior del historial de navegación.Use the GoBack method to return the control to a previous page in the navigation history. Use el GoForward método para volver a una página posterior del historial de navegación después de desplazarse hacia atrás.Use the GoForward method to return to a later page in the navigation history after navigating backward.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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.

Consulte también

Se aplica a

Navigate(String, Boolean)

Carga el documento del Localizador uniforme de recursos (URL) especificado en una nueva ventana del explorador o en el control 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)

Parámetros

urlString
String

Dirección URL del documento que se va a cargar.The URL of the document to load.

newWindow
Boolean

Es true para cargar el documento en una nueva ventana del explorador; es false para cargar el documento en el control WebBrowser.true to load the document into a new browser window; false to load the document into the WebBrowser control.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de false , el control navega al URI especificado con normalidad y agrega el URI al final de la lista de historial.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. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de true , el WebBrowser control carga el documento en el URI especificado en una nueva ventana de Internet Explorer, que mantiene su propio historial de navegación.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. Puede controlar el NewWindow evento para recibir notificaciones antes de que se abra una nueva ventana del explorador, lo que le permite cancelar la acción si es necesario.You can handle the NewWindow event to receive notification before a new browser window is opened, allowing you to cancel the action if necessary.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página o carga una página en una ventana del explorador independiente, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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. Cuando se carga una página en una ventana independiente de Internet Explorer, el usuario puede recuperar la versión más reciente haciendo clic en el botón Actualizar .When a page is loaded into a separate Internet Explorer window, the user can retrieve the latest version by clicking the Refresh button.

Consulte también

Se aplica a

Navigate(String, String)

Carga el documento del Localizador uniforme de recursos (URL) especificado en el control WebBrowser y reemplaza el contenido del marco de la página web por el nombre especificado.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)

Parámetros

urlString
String

Dirección URL del documento que se va a cargar.The URL of the document to load.

targetFrameName
String

Nombre del marco en el que se carga el documento.The name of the frame in which to load the document.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de la página web con el nombre especificado y agrega el URI al final de la lista del historial.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 el nombre del marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Use el GoBack método para devolver el control a una página anterior del historial de navegación.Use the GoBack method to return the control to a previous page in the navigation history. Use el GoForward método para volver a una página posterior del historial de navegación después de desplazarse hacia atrás.Use the GoForward method to return to a later page in the navigation history after navigating backward.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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.

Consulte también

Se aplica a

Navigate(Uri)

Carga el documento en la ubicación indicada por el Uri especificado en el control WebBrowser y reemplaza el documento anterior.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)

Parámetros

url
Uri

Uri que representa la dirección URL del documento que se va a cargar.A Uri representing the URL of the document to load.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

El valor de parámetro url no representa un URI absoluto.The url parameter value does not represent an absolute URI. Para obtener más información, vea IsAbsoluteUri.For more information, see IsAbsoluteUri.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el Navigate método para implementar una barra de direcciones para el WebBrowser control.The following code example demonstrates how to use the Navigate method to implement an address bar for the WebBrowser control. Este ejemplo requiere que el formulario contenga un WebBrowser control denominado webBrowser1 , un TextBox control denominado TextBoxAddress y un Button control denominado ButtonGo .This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. Cuando escriba una dirección URL en el cuadro de texto y presione Entrar o haga clic en el botón ir , el WebBrowser control navegará a la dirección URL especificada.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. Cuando se navega haciendo clic en un hipervínculo, el cuadro de texto se actualiza automáticamente para mostrar la dirección URL actual.When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

Para obtener el ejemplo de código completo, vea Cómo: agregar capacidades del explorador Web a una aplicación 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

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga, el WebBrowser control navega al URI especificado y lo agrega al final de la lista de historial.When you call this overload, the WebBrowser control navigates to the specified URI and adds it to the end of the history list. Use el GoBack método para devolver el control a una página anterior del historial de navegación.Use the GoBack method to return the control to a previous page in the navigation history. Use el GoForward método para volver a una página posterior del historial de navegación después de desplazarse hacia atrás.Use the GoForward method to return to a later page in the navigation history after navigating backward.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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.

Puede usar el Navigate método para implementar una barra de direcciones similar a la de Internet Explorer.You can use the Navigate method to implement an address bar similar to the one in Internet Explorer.

Consulte también

Se aplica a

Navigate(String)

Carga el documento del Localizador uniforme de recursos (URL) especificado en el control WebBrowser y reemplaza el documento anterior.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)

Parámetros

urlString
String

Dirección URL del documento que se va a cargar.The URL of the document to load.

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Cuando se llama a esta sobrecarga, el WebBrowser control navega al URI especificado y lo agrega al final de la lista de historial.When you call this overload, the WebBrowser control navigates to the specified URI and adds it to the end of the history list. Use el GoBack método para devolver el control a una página anterior del historial de navegación.Use the GoBack method to return the control to a previous page in the navigation history. Use el GoForward método para volver a una página posterior del historial de navegación después de desplazarse hacia atrás.Use the GoForward method to return to a later page in the navigation history after navigating backward.

El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Cada página puede especificar una fecha de expiración que indica cuánto tiempo permanecerá en la memoria caché.Each page can specify an expiration date indicating how long it will remain in the cache. Cuando el control navega a una página, se ahorra tiempo al mostrar una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página.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. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descargándolo, asegurándose de que el control muestra la versión más reciente.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.

Puede usar el Navigate método para implementar una barra de direcciones similar a la de Internet Explorer.You can use the Navigate method to implement an address bar similar to the one in Internet Explorer.

Consulte también

Se aplica a