Hinweis: Diese Methode ist neu in .NET Framework, Version 2.0.
Lädt das gegenwärtig im
WebBrowser-Steuerelement angezeigte Dokument erneut, indem der Server auf eine neue Version überprüft wird.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Visual Basic (Deklaration)
Public Overrides Sub Refresh
Visual Basic (Verwendung)
Dim instance As WebBrowser
instance.Refresh
public override void Refresh ()
public:
virtual void Refresh () override
public override function Refresh ()
Das WebBrowser-Steuerelement speichert Webseiten kürzlich besuchter Websites im Cache auf der lokalen Festplatte. Jede Seite kann ein Ablaufdatum angeben, das die Verweildauer im Cache bestimmt. Wenn das Steuerelement zu einer Seite navigiert, zeigt es aus Gründen der Beschleunigung eine Version aus dem Cache an (sofern verfügbar), anstatt die Seite erneut zu downloaden. Die Refresh-Methode zwingt das WebBrowser-Steuerelement, die aktuelle Seite durch Downloaden erneut zu laden, sodass die neueste Version angezeigt wird. Mit dieser Methode können Sie eine Schaltfläche Aktualisieren (wie in Internet Explorer) implementieren.
Hinweis |
|---|
| Bei einer Dokumentaktualisierung wird die aktuelle Seite einfach erneut geladen, daher treten beim Aufrufen der Refresh-Methode kein Navigating-Ereignis, Navigated-Ereignis und DocumentCompleted-Ereignis ein. |
Im folgenden Codebeispiel wird veranschaulicht, wie mit der Refresh-Methode eine Schaltfläche Aktualisieren (wie in Internet Explorer) für das WebBrowser-Steuerelement implementiert wird. Für dieses Beispiel ist erforderlich, dass das Formular ein WebBrowser-Steuerelement mit dem Namen webBrowser1 und ein Button-Steuerelement mit dem Namen ButtonRefresh enthält.
Das vollständige Codebeispiel finden Sie unter Gewusst wie: Hinzufügen von Webbrowserfunktionen zu einer Windows Forms-Anwendung.
' 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
// 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.
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();
}
}
.NET Framework-Sicherheit
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
.NET Framework
Unterstützt in: 2.0
.NET Compact Framework
Unterstützt in: 2.0