WebBrowser.Navigate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Carga el documento en la ubicación especificada en el WebBrowser control .
Sobrecargas
| Nombre | Description |
|---|---|
| Navigate(Uri, String, Byte[], String) |
Carga el documento en la ubicación indicada por el especificado Uri en el WebBrowser control, solicitándolo mediante los datos HTTP especificados y reemplazando el contenido del marco de página web por el nombre especificado. |
| Navigate(String, String, Byte[], String) |
Carga el documento en el localizador uniforme de recursos (URL) especificado en el WebBrowser control, solicitándolo con los datos HTTP especificados y reemplazando el contenido del marco de página web por el nombre especificado. |
| Navigate(Uri, Boolean) |
Carga el documento en la ubicación indicada por el especificado Uri en una nueva ventana del explorador o en el WebBrowser control . |
| Navigate(Uri, String) |
Carga el documento en la ubicación indicada por el especificado Uri en el WebBrowser control, reemplazando el contenido del marco de página web por el nombre especificado. |
| Navigate(String, Boolean) |
Carga el documento en el localizador uniforme de recursos (URL) especificado en una nueva ventana del explorador o en el WebBrowser control . |
| Navigate(String, String) |
Carga el documento en el localizador uniforme de recursos (URL) especificado en el WebBrowser control, reemplazando el contenido del marco de página web por el nombre especificado. |
| Navigate(Uri) |
Carga el documento en la ubicación indicada por el especificado Uri en el WebBrowser control, reemplazando el documento anterior. |
| Navigate(String) |
Carga el documento en el localizador uniforme de recursos (URL) especificado en el WebBrowser control, reemplazando el documento anterior. |
Navigate(Uri, String, Byte[], String)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en la ubicación indicada por el especificado Uri en el WebBrowser control, solicitándolo mediante los datos HTTP especificados y reemplazando el contenido del marco de página web por el nombre especificado.
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)
Parámetros
- targetFrameName
- String
Nombre del marco en el que se va a cargar el documento.
- postData
- Byte[]
Datos HTTP POST, como datos de formulario.
- additionalHeaders
- String
Encabezados HTTP que se van a agregar a los encabezados predeterminados.
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
El url valor del parámetro no representa un URI absoluto. Para obtener más información, consulte IsAbsoluteUri.
Comentarios
El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de página web con el nombre especificado y agrega el URI al final de la lista de historial. Si el nombre de marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.
Use el GoBack método para devolver el control a una página anterior del historial de navegación. Use el GoForward método para volver a una página posterior del historial de navegación después de navegar hacia atrás.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página, ahorra tiempo mostrando una versión almacenada en caché, si hay disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente.
Consulte también
Se aplica a
Navigate(String, String, Byte[], String)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en el localizador uniforme de recursos (URL) especificado en el WebBrowser control, solicitándolo con los datos HTTP especificados y reemplazando el contenido del marco de página web por el nombre especificado.
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)
Parámetros
- urlString
- String
Dirección URL del documento que se va a cargar.
- targetFrameName
- String
Nombre del marco en el que se va a cargar el documento.
- postData
- Byte[]
Datos HTTP POST, como datos de formulario.
- additionalHeaders
- String
Encabezados HTTP que se van a agregar a los encabezados predeterminados.
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
Comentarios
El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de página web con el nombre especificado y agrega el URI al final de la lista de historial. Si el nombre de marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.
Use el GoBack método para devolver el control a una página anterior del historial de navegación. Use el GoForward método para volver a una página posterior del historial de navegación después de navegar hacia atrás.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página, ahorra tiempo mostrando una versión almacenada en caché, si hay disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente.
Consulte también
Se aplica a
Navigate(Uri, Boolean)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en la ubicación indicada por el especificado Uri en una nueva ventana del explorador o en el WebBrowser control .
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)
Parámetros
- newWindow
- Boolean
true para cargar el documento en una nueva ventana del explorador; false para cargar el documento en el WebBrowser control .
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
El url valor del parámetro no representa un URI absoluto. Para obtener más información, consulte IsAbsoluteUri.
Comentarios
El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de false, el control navega al URI especificado normalmente y agrega el URI al final de la lista de historial. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de true, el control WebBrowser carga el documento en el URI especificado en una nueva ventana de Internet Explorer, que mantiene su propio historial de navegación. 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.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página o carga una página en una ventana del explorador independiente, ahorra tiempo mostrando una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente. Cuando se carga una página en una ventana de Internet Explorer independiente, el usuario puede recuperar la versión más reciente haciendo clic en el botón Refresh.
Consulte también
Se aplica a
Navigate(Uri, String)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en la ubicación indicada por el especificado Uri en el WebBrowser control, reemplazando el contenido del marco de página web por el nombre especificado.
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)
Parámetros
- targetFrameName
- String
Nombre del marco en el que se va a cargar el documento.
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
El url valor del parámetro no representa un URI absoluto. Para obtener más información, consulte IsAbsoluteUri.
Comentarios
El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de página web con el nombre especificado y agrega el URI al final de la lista de historial. Si el nombre de marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.
Use el GoBack método para devolver el control a una página anterior del historial de navegación. Use el GoForward método para volver a una página posterior del historial de navegación después de navegar hacia atrás.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página, ahorra tiempo mostrando una versión almacenada en caché, si hay disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente.
Consulte también
Se aplica a
Navigate(String, Boolean)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en el localizador uniforme de recursos (URL) especificado en una nueva ventana del explorador o en el 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.
- newWindow
- Boolean
true para cargar el documento en una nueva ventana del explorador; false para cargar el documento en el WebBrowser control .
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
Comentarios
El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de false, el control navega al URI especificado normalmente y agrega el URI al final de la lista de historial. Cuando se llama a esta sobrecarga con un newWindow valor de parámetro de true, el control WebBrowser carga el documento en el URI especificado en una nueva ventana de Internet Explorer, que mantiene su propio historial de navegación. 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.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página o carga una página en una ventana del explorador independiente, ahorra tiempo mostrando una versión almacenada en caché, si hay una disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente. Cuando se carga una página en una ventana de Internet Explorer independiente, el usuario puede recuperar la versión más reciente haciendo clic en el botón Refresh.
Consulte también
Se aplica a
Navigate(String, String)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en el localizador uniforme de recursos (URL) especificado en el WebBrowser control, reemplazando el contenido del marco de página web por el nombre especificado.
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)
Parámetros
- urlString
- String
Dirección URL del documento que se va a cargar.
- targetFrameName
- String
Nombre del marco en el que se va a cargar el documento.
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
Comentarios
El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. Cuando se llama a esta sobrecarga, el WebBrowser control carga el documento en el URI especificado en el marco de página web con el nombre especificado y agrega el URI al final de la lista de historial. Si el nombre de marco especificado no es válido, el documento se carga en una nueva ventana de Internet Explorer.
Use el GoBack método para devolver el control a una página anterior del historial de navegación. Use el GoForward método para volver a una página posterior del historial de navegación después de navegar hacia atrás.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página, ahorra tiempo mostrando una versión almacenada en caché, si hay disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente.
Consulte también
Se aplica a
Navigate(Uri)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en la ubicación indicada por el especificado Uri en el WebBrowser control, reemplazando el documento anterior.
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)
Parámetros
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
El url valor del parámetro no representa un URI absoluto. Para obtener más información, consulte IsAbsoluteUri.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el Navigate método para implementar una barra de direcciones para el WebBrowser control. En este ejemplo se requiere que el formulario contenga un control denominado WebBrowser, un webBrowser1 control denominado TextBoxy un TextBoxAddress control denominado Button.ButtonGo Al escribir una dirección URL en el cuadro de texto y presionar ENTRAR o hacer clic en el botón Ir , el WebBrowser control navega a la dirección URL especificada. Al navegar haciendo clic en un hipervínculo, el cuadro de texto se actualiza automáticamente para mostrar la dirección URL actual.
Para obtener el ejemplo de código completo, vea 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. Cuando se llama a esta sobrecarga, el WebBrowser control navega al URI especificado y lo agrega al final de la lista de historial. Use el GoBack método para devolver el control a una página anterior del historial de navegación. Use el GoForward método para volver a una página posterior del historial de navegación después de navegar hacia atrás.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página, ahorra tiempo mostrando una versión almacenada en caché, si hay disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente.
Puede usar el método Navigate para implementar una barra de direcciones similar a la de Internet Explorer.
Consulte también
Se aplica a
Navigate(String)
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
- Source:
- WebBrowser.cs
Carga el documento en el localizador uniforme de recursos (URL) especificado en el WebBrowser control, reemplazando el documento anterior.
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.
Excepciones
Esta WebBrowser instancia ya no es válida.
No se pudo recuperar una referencia a una implementación de la IWebBrowser2 interfaz del control ActiveX WebBrowser subyacente.
Comentarios
El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. Cuando se llama a esta sobrecarga, el WebBrowser control navega al URI especificado y lo agrega al final de la lista de historial. Use el GoBack método para devolver el control a una página anterior del historial de navegación. Use el GoForward método para volver a una página posterior del historial de navegación después de navegar hacia atrás.
El WebBrowser control almacena páginas web de sitios visitados recientemente en una memoria caché en el disco duro local. Cada página puede especificar una fecha de expiración que indique cuánto tiempo permanecerá en la memoria caché. Cuando el control navega a una página, ahorra tiempo mostrando una versión almacenada en caché, si hay disponible, en lugar de volver a descargar la página. Use el Refresh método para forzar que el WebBrowser control vuelva a cargar la página actual descárguelo, asegurándose de que el control muestra la versión más reciente.
Puede usar el método Navigate para implementar una barra de direcciones similar a la de Internet Explorer.