WebBrowser.Refresh Metodo

Definizione

Ricarica il documento attualmente visualizzato nel controllo WebBrowser.Reloads the document currently displayed in the WebBrowser control.

Overload

Refresh()

Ricarica il documento attualmente visualizzato nel controllo WebBrowser verificando l'esistenza di una versione aggiornata sul server.Reloads the document currently displayed in the WebBrowser control by checking the server for an updated version.

Refresh(WebBrowserRefreshOption)

Ricarica il documento attualmente visualizzato nel controllo WebBrowser usando le opzioni di aggiornamento specificate.Reloads the document currently displayed in the WebBrowser control using the specified refresh options.

Refresh()

Ricarica il documento attualmente visualizzato nel controllo WebBrowser verificando l'esistenza di una versione aggiornata sul server.Reloads the document currently displayed in the WebBrowser control by checking the server for an updated version.

public:
 override void Refresh();
public override void Refresh ();
override this.Refresh : unit -> unit
Public Overrides Sub Refresh ()

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il Refresh metodo per implementare un pulsante di aggiornamento per il WebBrowser controllo simile a quello in Internet Explorer.The following code example demonstrates how to use the Refresh method to implement a Refresh button for the WebBrowser control similar to the one in Internet Explorer. Questo esempio richiede che il form contenga un WebBrowser controllo denominato webBrowser1 e un Button controllo denominato ButtonRefresh .This example requires that your form contains a WebBrowser control called webBrowser1 and a Button control called ButtonRefresh.

Per l'esempio di codice completo, vedere procedura: aggiungere funzionalità del browser Web a un'applicazione Windows Forms.For the complete code example, see 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

Commenti

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.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. Il Refresh metodo impone al WebBrowser controllo di ricaricare la pagina corrente eseguendone il download, assicurando che il controllo visualizzi la versione più recente.The Refresh method forces the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. È possibile utilizzare questo metodo per implementare un pulsante di aggiornamento simile a quello in Internet Explorer.You can use this method to implement a Refresh button similar to the one in Internet Explorer.

Nota

Un aggiornamento del documento consente semplicemente di ricaricare la pagina corrente, quindi gli Navigating eventi, e non si Navigated DocumentCompleted verificano quando si chiama il Refresh metodo.A document refresh simply reloads the current page, so the Navigating, Navigated, and DocumentCompleted events do not occur when you call the Refresh method.

Vedi anche

Si applica a

Refresh(WebBrowserRefreshOption)

Ricarica il documento attualmente visualizzato nel controllo WebBrowser usando le opzioni di aggiornamento specificate.Reloads the document currently displayed in the WebBrowser control using the specified refresh options.

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)

Parametri

Commenti

Il WebBrowser controllo archivia le pagine Web visitate di recente in una cache sul disco rigido locale.The WebBrowser control stores recently visited Web pages in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.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. Il Refresh metodo impone al WebBrowser controllo di ricaricare la pagina corrente.The Refresh method forces the WebBrowser control to reload the current page. Il tipo di ricaricamento dipende dal WebBrowserRefreshOption valore specificato.The type of reload depends on the WebBrowserRefreshOption value specified. Se si chiama il Refresh metodo con il WebBrowserRefreshOption.Completely valore, viene scaricata la versione più recente del documento.If you call the Refresh method with the WebBrowserRefreshOption.Completely value, the latest version of the document is downloaded. Se si usa il WebBrowserRefreshOption.IfExpired valore, la versione più recente viene scaricata solo se il documento corrente è scaduto.If you use the WebBrowserRefreshOption.IfExpired value, the latest version is downloaded only if the current document has expired. Se si usa il WebBrowserRefreshOption.Normal valore, il server invia una copia del documento archiviato nella relativa cache.If you use the WebBrowserRefreshOption.Normal value, the server sends a copy of the document stored in its own cache.

Nota

Un aggiornamento del documento consente semplicemente di ricaricare la pagina corrente, quindi gli Navigating eventi, e non si Navigated DocumentCompleted verificano quando si chiama il Refresh metodo.A document refresh simply reloads the current page, so the Navigating, Navigated, and DocumentCompleted events do not occur when you call the Refresh method.

Vedi anche

Si applica a