WebBrowser.Refresh Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ricarica il documento attualmente visualizzato nel controllo WebBrowser.

Overload

Refresh()	Ricarica il documento attualmente visualizzato nel controllo WebBrowser verificando l'esistenza di una versione aggiornata sul server.
Refresh(WebBrowserRefreshOption)	Ricarica il documento attualmente visualizzato nel controllo WebBrowser usando le opzioni di aggiornamento specificate.

Refresh()

Ricarica il documento attualmente visualizzato nel controllo WebBrowser verificando l'esistenza di una versione aggiornata sul server.

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 Refresh per il WebBrowser controllo simile a quello in Internet Explorer. In questo esempio è necessario che il form contenga un WebBrowser controllo denominato webBrowser1 e un Button controllo denominato ButtonRefresh.

Per l'esempio di codice completo, vedere Procedura: Aggiungere funzionalità del Web browser a un'applicazione Windows Forms.

// 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 dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Il Refresh metodo forza il WebBrowser controllo a ricaricare la pagina corrente scaricandola, assicurandosi che il controllo visualizzi la versione più recente. È possibile utilizzare questo metodo per implementare un pulsante Refresh simile a quello in Internet Explorer.

Nota

Un aggiornamento del documento ricarica semplicemente la pagina corrente, quindi gli Navigatingeventi , Navigatede DocumentCompleted non si verificano quando si chiama il Refresh metodo .

Vedi anche

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

Refresh(WebBrowserRefreshOption)

Ricarica il documento attualmente visualizzato nel controllo WebBrowser usando le opzioni di aggiornamento specificate.

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

opt

WebBrowserRefreshOption

Uno dei valori di WebBrowserRefreshOption.

Commenti

Il WebBrowser controllo archivia le pagine Web visitate di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Il Refresh metodo forza il WebBrowser controllo a ricaricare la pagina corrente. Il tipo di ricaricamento dipende WebBrowserRefreshOption dal valore specificato. Se si chiama il metodo con il RefreshWebBrowserRefreshOption.Completely valore , viene scaricata la versione più recente del documento. Se si usa il WebBrowserRefreshOption.IfExpired valore , la versione più recente viene scaricata solo se il documento corrente è scaduto. Se si utilizza il WebBrowserRefreshOption.Normal valore , il server invia una copia del documento archiviato nella propria cache.

Nota

Un aggiornamento del documento ricarica semplicemente la pagina corrente, quindi gli Navigatingeventi , Navigatede DocumentCompleted non si verificano quando si chiama il Refresh metodo .

Vedi anche

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