WebBrowser.Refresh Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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 -> unit

Public 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

• GoBack()
• GoForward()
• GoHome()
• GoSearch()
• Stop()

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 -> unit

Public Sub Refresh (opt As WebBrowserRefreshOption)

Parámetros

opt

WebBrowserRefreshOption

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 .

Consulte también

• GoBack()
• GoForward()
• GoHome()
• GoSearch()
• Stop()