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 Forms應用程式。

// 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 會將最近流覽的網站網頁儲存在本機硬碟上的快取中。 每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。 當控制項巡覽至頁面時，如果有快取的版本可用，它可節省時間，而不是再次下載頁面。 Refresh方法會 WebBrowser 強制控制項藉由下載它來重載目前的頁面，以確保控制項會顯示最新版本。 您可以使用此方法來實作與 Internet Explorer 中類似的 [ 重新 整理] 按鈕。

注意

檔重新整理只會重載目前的頁面，因此 Navigating 當您呼叫 Refresh 方法時，不會發生 、 Navigated 和 DocumentCompleted 事件。

另請參閱

• 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 值，伺服器會傳送儲存在其專屬快取中的檔複本。

注意

檔重新整理只會重載目前的頁面，因此 Navigating 當您呼叫 Refresh 方法時，不會發生 、 Navigated 和 DocumentCompleted 事件。

另請參閱

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