WebBrowser.Refresh Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Znovu načte dokument aktuálně zobrazený v ovládacím WebBrowser prvku.

Přetížení

Refresh()	Znovu načte dokument, který se aktuálně zobrazuje v ovládacím WebBrowser prvku, tím, že zkontroluje aktualizovanou verzi serveru.
Refresh(WebBrowserRefreshOption)	Znovu načte dokument aktuálně zobrazený v ovládacím WebBrowser prvku pomocí zadaných možností aktualizace.

Refresh()

Znovu načte dokument, který se aktuálně zobrazuje v ovládacím WebBrowser prvku, tím, že zkontroluje aktualizovanou verzi serveru.

public:
 override void Refresh();

public override void Refresh ();

override this.Refresh : unit -> unit

Public Overrides Sub Refresh ()

Příklady

Následující příklad kódu ukazuje, jak použít metodu Refresh k implementaci tlačítka Refresh pro WebBrowser ovládací prvek podobně jako v aplikaci Internet Explorer. Tento příklad vyžaduje, aby formulář obsahoval WebBrowser ovládací prvek s názvem webBrowser1 a Button ovládací prvek s názvem ButtonRefresh.

Kompletní příklad kódu najdete v tématu Postupy: Přidání funkcí webového prohlížeče do aplikace model 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

Poznámky

Ovládací WebBrowser prvek ukládá webové stránky z naposledy navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti, které určuje, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti(pokud je k dispozici) místo opětovného stažení stránky. Metoda Refresh vynutí WebBrowser , aby ovládací prvek znovu načte aktuální stránku tím, že ji stáhne a zajistí, že ovládací prvek zobrazí nejnovější verzi. Tuto metodu můžete použít k implementaci tlačítka Aktualizovat podobně jako v Internet Exploreru.

Poznámka

Aktualizace dokumentu jednoduše znovu načte aktuální stránku, takže Navigatingpři volání Refresh metody nedojde k událostem , Navigateda DocumentCompleted .

Viz také

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

Refresh(WebBrowserRefreshOption)

Znovu načte dokument aktuálně zobrazený v ovládacím WebBrowser prvku pomocí zadaných možností aktualizace.

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)

Parametry

opt

WebBrowserRefreshOption

Jedna z WebBrowserRefreshOption hodnot.

Poznámky

Ovládací WebBrowser prvek ukládá nedávno navštívené webové stránky do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti, které určuje, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti(pokud je k dispozici) místo opětovného stažení stránky. Metoda Refresh vynutí WebBrowser , aby ovládací prvek znovu načte aktuální stránku. Typ opětovného načtení závisí na zadané hodnotě WebBrowserRefreshOption . Pokud zavoláte metodu RefreshWebBrowserRefreshOption.Completely s hodnotou , stáhne se nejnovější verze dokumentu. Pokud použijete WebBrowserRefreshOption.IfExpired hodnotu , stáhne se nejnovější verze jenom v případě, že vypršela platnost aktuálního dokumentu. Pokud použijete WebBrowserRefreshOption.Normal hodnotu , server odešle kopii dokumentu uloženou ve své vlastní mezipaměti.

Poznámka

Aktualizace dokumentu jednoduše znovu načte aktuální stránku, takže Navigatingpři volání Refresh metody nedojde k událostem , Navigateda DocumentCompleted .

Viz také

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