WebBrowser.Refresh 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í.
Vuelve a cargar el documento que se muestra actualmente en el control WebBrowser.
Sobrecargas
| Refresh() |
Vuelve a cargar el documento que se muestra actualmente en el control WebBrowser; para ello, busca una versión actualizada en el servidor. |
| Refresh(WebBrowserRefreshOption) |
Vuelve a cargar el documento que se muestra actualmente en el control WebBrowser mediante las opciones de actualización especificadas. |
Refresh()
Vuelve a cargar el documento que se muestra actualmente en el control WebBrowser; para ello, busca una versión actualizada en el servidor.
public:
override void Refresh();public override void Refresh ();override this.Refresh : unit -> unitPublic Overrides Sub Refresh ()Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el Refresh método para implementar un botón Actualizar para el WebBrowser control similar al del de Internet Explorer. En este ejemplo se requiere que el formulario contenga un WebBrowser control denominado webBrowser1 y un Button control denominado ButtonRefresh.
Para obtener el ejemplo de código completo, vea How to: Add Web Browser Capabilities to a Windows Forms Application.
// Reloads the current page.
void ButtonRefresh_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Skip refresh if about:blank is loaded to avoid removing
// content specified by the DocumentText property.
if ( !this->WebBrowser1->Url->Equals( "about:blank" ) )
{
this->WebBrowser1->Refresh();
}
}
// Reloads the current page.
private void refreshButton_Click(object sender, EventArgs e)
{
// Skip refresh if about:blank is loaded to avoid removing
// content specified by the DocumentText property.
if (!webBrowser1.Url.Equals("about:blank"))
{
webBrowser1.Refresh();
}
}
' Reloads the current page.
Private Sub refreshButton_Click( _
ByVal sender As Object, ByVal e As EventArgs) _
Handles refreshButton.Click
' Skip refresh if about:blank is loaded to avoid removing
' content specified by the DocumentText property.
If Not webBrowser1.Url.Equals("about:blank") Then
webBrowser1.Refresh()
End If
End Sub
Comentarios
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 una disponible, en lugar de volver a descargar la página. El Refresh método obliga al WebBrowser control a volver a cargar la página actual descargóla, asegurándose de que el control muestra la versión más reciente. Puede usar este método para implementar un botón Actualizar similar al de Internet Explorer.
Nota
Una actualización del documento simplemente vuelve a cargar la página actual, por lo que los Navigatingeventos , Navigatedy DocumentCompleted no se producen cuando se llama al Refresh método .
Consulte también
Se aplica a
Refresh(WebBrowserRefreshOption)
Vuelve a cargar el documento que se muestra actualmente en el control WebBrowser mediante las opciones de actualización especificadas.
public:
void Refresh(System::Windows::Forms::WebBrowserRefreshOption opt);public void Refresh (System.Windows.Forms.WebBrowserRefreshOption opt);override this.Refresh : System.Windows.Forms.WebBrowserRefreshOption -> unitPublic Sub Refresh (opt As WebBrowserRefreshOption)Parámetros
Uno de los valores de WebBrowserRefreshOption.
Comentarios
El WebBrowser control almacena las páginas web visitadas 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 una disponible, en lugar de volver a descargar la página. El Refresh método obliga al WebBrowser control a volver a cargar la página actual. El tipo de recarga depende del WebBrowserRefreshOption valor especificado. Si llama al Refresh método con el WebBrowserRefreshOption.Completely valor , se descarga la versión más reciente del documento. Si usa el WebBrowserRefreshOption.IfExpired valor , la versión más reciente solo se descarga si el documento actual ha expirado. Si usa el WebBrowserRefreshOption.Normal valor , el servidor envía una copia del documento almacenado en su propia memoria caché.
Nota
Una actualización del documento simplemente vuelve a cargar la página actual, por lo que los Navigatingeventos , Navigatedy DocumentCompleted no se producen cuando se llama al Refresh método .
