WebBrowser.Refresh Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic Overrides Sub Refresh ()Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Refresh -Methode eine Schaltfläche Aktualisieren für das Steuerelement implementieren, das WebBrowser dem in Internet Explorer ähnelt. Dieses Beispiel erfordert, dass ihr Formular ein WebBrowser Steuerelement mit dem Namen webBrowser1 und ein Button Steuerelement mit dem Namen ButtonRefreshenthält.
Das vollständige Codebeispiel finden Sie unter Vorgehensweise: Hinzufügen von Webbrowserfunktionen zu einer Windows Forms-Anwendung.
// 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 kürzlich 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 es eine zwischengespeicherte Version anzeigt, wenn eine verfügbar ist, anstatt die Seite erneut herunterzuladen. Die Refresh -Methode zwingt das WebBrowser Steuerelement, die 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 zu implementieren, die der Internetverbindung Explorer ähnelt.
Hinweis
Eine Dokumentaktualisierung lädt einfach die aktuelle Seite neu, sodass die NavigatingEreignisse , Navigated, und DocumentCompleted nicht auftreten, wenn Sie die Refresh -Methode aufrufen.
Weitere Informationen
Gilt für:
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 -> unitPublic Sub Refresh (opt As WebBrowserRefreshOption)Parameter
Einer der WebBrowserRefreshOption-Werte.
Hinweise
Das WebBrowser Steuerelement speichert kürzlich 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 es eine zwischengespeicherte Version anzeigt, wenn eine verfügbar ist, anstatt die Seite erneut herunterzuladen. Die Refresh -Methode zwingt das WebBrowser Steuerelement, die aktuelle Seite neu zu laden. Der Typ des Neuladens hängt WebBrowserRefreshOption vom 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, sodass die NavigatingEreignisse , Navigated, und DocumentCompleted nicht auftreten, wenn Sie die Refresh -Methode aufrufen.
