WebBrowser.Refresh 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

重新加载当前显示在 WebBrowser 控件中的文档。

重载

Refresh()	通过检查服务器获取更新版本，重新加载当前显示在 WebBrowser 控件中的文档。
Refresh(WebBrowserRefreshOption)	使用指定的刷新选项重新加载当前显示在 WebBrowser 控件中的文档。

Refresh()

通过检查服务器获取更新版本，重新加载当前显示在 WebBrowser 控件中的文档。

public:
 override void Refresh();

public override void Refresh ();

override this.Refresh : unit -> unit

Public Overrides Sub Refresh ()

示例

下面的代码示例演示如何使用 Refresh 方法实现控件的WebBrowser“刷新”按钮，类似于 Internet Explorer 中的按钮。 此示例要求窗体包含名为 WebBrowser 的 webBrowser1 控件和 Button 名为 的 ButtonRefresh控件。

有关完整的代码示例，请参阅如何：向 Windows 窗体 应用程序添加 Web 浏览器功能。

// 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

注解

控件 WebBrowser 将最近访问过的网站的网页存储在本地硬盘上的缓存中。 每个页面都可以指定一个过期日期，指示它在缓存中的保留时间。 当控件导航到页面时，它通过显示缓存版本（如果可用）来节省时间，而不是再次下载页面。 方法RefreshWebBrowser通过下载强制控件重新加载当前页，确保控件显示最新版本。 可以使用此方法实现类似于 Internet Explorer 中的 “刷新” 按钮。

注意

文档刷新只是重新加载当前页，因此NavigatingNavigated， 和 DocumentCompleted 事件不会在调用 Refresh 方法时发生。

另请参阅

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

Refresh(WebBrowserRefreshOption)

使用指定的刷新选项重新加载当前显示在 WebBrowser 控件中的文档。

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)

参数

opt

WebBrowserRefreshOption

WebBrowserRefreshOption 值之一。

注解

控件 WebBrowser 将最近访问的网页存储在本地硬盘上的缓存中。 每个页面都可以指定一个过期日期，指示它在缓存中的保留时间。 当控件导航到页面时，它通过显示缓存版本（如果可用）来节省时间，而不是再次下载页面。 方法 Refresh 强制 WebBrowser 控件重新加载当前页。 重载的类型取决于指定的 WebBrowserRefreshOption 值。 如果使用 值调用 Refresh 方法 WebBrowserRefreshOption.Completely ，则会下载文档的最新版本。 如果使用 WebBrowserRefreshOption.IfExpired 值，则仅当当前文档已过期时才会下载最新版本。 如果使用 WebBrowserRefreshOption.Normal 值，服务器将发送存储在其自己的缓存中的文档的副本。

注意

文档刷新只是重新加载当前页，因此NavigatingNavigated， 和 DocumentCompleted 事件不会在调用 Refresh 方法时发生。

另请参阅

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