WebBrowser.Refresh Methode

Definition

Lädt das aktuell im WebBrowser Steuerelement angezeigte Dokument neu.

Überlädt

Name Beschreibung
Refresh()

Lädt das aktuell im WebBrowser Steuerelement angezeigte Dokument neu, indem der Server auf eine aktualisierte Version überprüft wird.

Refresh(WebBrowserRefreshOption)

Lädt das aktuell im WebBrowser Steuerelement angezeigte Dokument mithilfe der angegebenen Aktualisierungsoptionen neu.

Refresh()

Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs

Lädt das aktuell im WebBrowser Steuerelement angezeigte Dokument neu, indem der Server auf eine aktualisierte 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 die Refresh-Methode verwendet wird, um eine Refreshschaltfläche für das Steuerelement WebBrowser zu implementieren, das dem steuerelement in Internet Explorer ähnelt. Dieses Beispiel erfordert, dass Ihr Formular ein aufgerufenes WebBrowserwebBrowser1 Steuerelement und ein Steuerelement enthält, das Button 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, falls vorhanden, statt die Seite erneut herunterzuladen. Die Refresh Methode zwingt das WebBrowser Steuerelement, die aktuelle Seite neu zu laden, indem er sie herunterlädt, um sicherzustellen, dass das Steuerelement die neueste Version anzeigt. Sie können diese Methode verwenden, um eine schaltfläche Refresh ähnlich der Schaltfläche in Internet Explorer zu implementieren.

Note

Eine Dokumentaktualisierung lädt einfach die aktuelle Seite neu, sodass die NavigatingEreignisse Navigatedund DocumentCompleted Ereignisse beim Aufrufen der Refresh Methode nicht auftreten.

Weitere Informationen

Gilt für:

Refresh(WebBrowserRefreshOption)

Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs
Quelle:
WebBrowser.cs

Lädt das aktuell im WebBrowser Steuerelement angezeigte Dokument mithilfe der angegebenen Aktualisierungsoptionen neu.

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

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, falls vorhanden, statt die Seite erneut herunterzuladen. Die Refresh Methode erzwingt das WebBrowser Steuerelement, die aktuelle Seite neu zu laden. Der Typ des Neuladens hängt vom angegebenen Wert ab WebBrowserRefreshOption . 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.

Note

Eine Dokumentaktualisierung lädt einfach die aktuelle Seite neu, sodass die NavigatingEreignisse Navigatedund DocumentCompleted Ereignisse beim Aufrufen der Refresh Methode nicht auftreten.

Weitere Informationen

Gilt für: