WebBrowser.Refresh Metoda

Definice

Znovu načte dokument, který je aktuálně zobrazen v WebBrowser ovládacím prvku.Reloads the document currently displayed in the WebBrowser control.

Přetížení

Refresh()

Znovu načte dokument aktuálně zobrazený v WebBrowser ovládacím prvku zkontrolováním aktualizované verze na serveru.Reloads the document currently displayed in the WebBrowser control by checking the server for an updated version.

Refresh(WebBrowserRefreshOption)

Znovu načte dokument, který je aktuálně zobrazen v WebBrowser ovládacím prvku, pomocí zadaných možností aktualizace.Reloads the document currently displayed in the WebBrowser control using the specified refresh options.

Refresh()

Znovu načte dokument aktuálně zobrazený v WebBrowser ovládacím prvku zkontrolováním aktualizované verze na serveru.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 ()

Příklady

Následující příklad kódu ukazuje, jak použít Refresh metodu pro implementaci tlačítka aktualizovat pro WebBrowser ovládací prvek podobně jako v aplikaci 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. 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 .This example requires that your form contains a WebBrowser control called webBrowser1 and a Button control called ButtonRefresh.

Úplný příklad kódu naleznete v tématu How to: Přidání schopností webového prohlížeče do aplikace model 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

Poznámky

WebBrowserOvládací prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Na každé stránce může být zadáno datum vypršení platnosti, které určuje, jak dlouho zůstane mezipaměť v mezipaměti.Each page can specify an expiration date indicating how long it will remain in the cache. Když ovládací prvek přejde na stránku, šetří čas zobrazením verze v mezipaměti, pokud je k dispozici, místo opětovného stahování stránky.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. RefreshMetoda vynutí, aby WebBrowser ovládací prvek znovu načítat aktuální stránku stažením a zajistil tak, že ovládací prvek zobrazí nejnovější verzi.The Refresh method forces the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. Tuto metodu můžete použít k implementaci tlačítka aktualizovat , podobně jako v aplikaci Internet Explorer.You can use this method to implement a Refresh button similar to the one in Internet Explorer.

Poznámka

Aktualizace dokumentu jednoduše znovu načte aktuální stránku, takže Navigating Navigated události, a DocumentCompleted nejsou při volání metody k Refresh .A document refresh simply reloads the current page, so the Navigating, Navigated, and DocumentCompleted events do not occur when you call the Refresh method.

Viz také

Platí pro

Refresh(WebBrowserRefreshOption)

Znovu načte dokument, který je aktuálně zobrazen v WebBrowser ovládacím prvku, pomocí zadaných možností aktualizace.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)

Parametry

Poznámky

WebBrowserOvládací prvek ukládá nedávno navštívené webové stránky do mezipaměti na místním pevném disku.The WebBrowser control stores recently visited Web pages in a cache on the local hard disk. Na každé stránce může být zadáno datum vypršení platnosti, které určuje, jak dlouho zůstane mezipaměť v mezipaměti.Each page can specify an expiration date indicating how long it will remain in the cache. Když ovládací prvek přejde na stránku, šetří čas zobrazením verze v mezipaměti, pokud je k dispozici, místo opětovného stahování stránky.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. RefreshMetoda vynutí, aby WebBrowser ovládací prvek znovu načítat aktuální stránku.The Refresh method forces the WebBrowser control to reload the current page. Typ opětovného načtení závisí na WebBrowserRefreshOption zadané hodnotě.The type of reload depends on the WebBrowserRefreshOption value specified. Pokud voláte Refresh metodu s WebBrowserRefreshOption.Completely hodnotou, bude stažena nejnovější verze dokumentu.If you call the Refresh method with the WebBrowserRefreshOption.Completely value, the latest version of the document is downloaded. Použijete-li WebBrowserRefreshOption.IfExpired hodnotu, bude nejnovější verze stažena pouze v případě, že platnost aktuálního dokumentu vypršela.If you use the WebBrowserRefreshOption.IfExpired value, the latest version is downloaded only if the current document has expired. Pokud použijete WebBrowserRefreshOption.Normal hodnotu, server odešle kopii dokumentu uloženou ve vlastní mezipaměti.If you use the WebBrowserRefreshOption.Normal value, the server sends a copy of the document stored in its own cache.

Poznámka

Aktualizace dokumentu jednoduše znovu načte aktuální stránku, takže Navigating Navigated události, a DocumentCompleted nejsou při volání metody k Refresh .A document refresh simply reloads the current page, so the Navigating, Navigated, and DocumentCompleted events do not occur when you call the Refresh method.

Viz také

Platí pro