WebBrowser.Refresh Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Lädt das im WebBrowser-Steuerelement gegenwärtig angezeigte Dokument erneut.

Überlädt

Refresh()	Lädt das gegenwärtig im WebBrowser-Steuerelement angezeigte Dokument erneut, indem der Server auf eine neue Version überprüft wird.
Refresh(WebBrowserRefreshOption)	Lädt das gegenwärtig im WebBrowser-Steuerelement angezeigte Dokument mit den angegebenen Aktualisierungsoptionen erneut.

Refresh()

Lädt das gegenwärtig im WebBrowser-Steuerelement angezeigte Dokument erneut, indem der Server auf eine neue Version überprüft wird.

public:
 override void Refresh();

public override void Refresh ();

override this.Refresh : unit -> unit

Public Overrides Sub Refresh ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Refresh Methode eine Aktualisierungsschaltfläche für das Steuerelement implementieren, das WebBrowser dem Steuerelement ähnlich wie in Internet Explorer entspricht. In diesem Beispiel ist erforderlich, dass Ihr Formular ein WebBrowser Steuerelement enthält, das aufgerufen webBrowser1 wird und ein Button Steuerelement aufgerufen wird ButtonRefresh.

Das vollständige Codebeispiel finden Sie unter 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

Hinweise

Das WebBrowser Steuerelement speichert Webseiten von zuletzt besuchten Websites in einem Cache auf der lokalen Festplatte. Jede Seite kann ein Ablaufdatum angeben, das angibt, wie lange sie im Cache verbleibt. Wenn das Steuerelement zu einer Seite navigiert, spart es Zeit, indem eine zwischengespeicherte Version angezeigt wird, wenn eine verfügbar ist, anstatt die Seite erneut herunterzuladen. Die Refresh Methode erzwingt das Steuerelement, die WebBrowser aktuelle Seite neu zu laden, indem sie heruntergeladen wird, um sicherzustellen, dass das Steuerelement die neueste Version anzeigt. Sie können diese Methode verwenden, um eine Schaltfläche "Aktualisieren " wie in Internet Explorer zu implementieren.

Hinweis

Eine Dokumentaktualisierung lädt einfach die aktuelle Seite neu, daher treten die NavigatingEreignisse Navigatedund DocumentCompleted Ereignisse nicht auf, wenn Sie die Refresh Methode aufrufen.

Siehe auch

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

Refresh(WebBrowserRefreshOption)

Lädt das gegenwärtig im WebBrowser-Steuerelement angezeigte Dokument mit den angegebenen Aktualisierungsoptionen erneut.

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)

Parameter

opt

WebBrowserRefreshOption

Einer der WebBrowserRefreshOption-Werte.

Hinweise

Das WebBrowser Steuerelement speichert zuletzt besuchte Webseiten in einem Cache auf der lokalen Festplatte. Jede Seite kann ein Ablaufdatum angeben, das angibt, wie lange sie im Cache verbleibt. Wenn das Steuerelement zu einer Seite navigiert, spart es Zeit, indem eine zwischengespeicherte Version angezeigt wird, wenn eine verfügbar ist, anstatt die Seite erneut herunterzuladen. Die Refresh Methode erzwingt das WebBrowser Steuerelement, die aktuelle Seite neu zu laden. Der Typ des Neuladens hängt vom WebBrowserRefreshOption angegebenen Wert ab. Wenn Sie die Refresh Methode mit dem WebBrowserRefreshOption.Completely Wert aufrufen, wird die neueste Version des Dokuments heruntergeladen. Wenn Sie den WebBrowserRefreshOption.IfExpired Wert verwenden, wird die neueste Version nur heruntergeladen, wenn das aktuelle Dokument abgelaufen ist. Wenn Sie den WebBrowserRefreshOption.Normal Wert verwenden, sendet der Server eine Kopie des Dokuments, das im eigenen Cache gespeichert ist.

Hinweis

Eine Dokumentaktualisierung lädt einfach die aktuelle Seite neu, daher treten die NavigatingEreignisse Navigatedund DocumentCompleted Ereignisse nicht auf, wenn Sie die Refresh Methode aufrufen.

Siehe auch

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