WebBrowser.Refresh Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Si applica a
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
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 .