WebBrowser.Refresh 方法

定義

重新載入目前在 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 方法時,不會發生 、 NavigatedDocumentCompleted 事件。

另請參閱

適用於

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)

參數

備註

控制項 WebBrowser 會將最近流覽過的網頁儲存在本機硬碟上的快取中。 每個頁面都可以指定到期日,指出其會保留在快取中的時間長度。 當控制項巡覽至頁面時,如果有快取的版本可用,它可節省時間,而不是再次下載頁面。 方法 RefreshWebBrowser 強制控制項重載目前的頁面。 重載的類型取決於 WebBrowserRefreshOption 指定的值。 如果您使用 值呼叫 Refresh 方法 WebBrowserRefreshOption.Completely ,則會下載最新版的檔。 如果您使用 WebBrowserRefreshOption.IfExpired 值,則只有在目前檔已過期時,才會下載最新版本。 如果您使用 WebBrowserRefreshOption.Normal 值,伺服器會傳送儲存在其專屬快取中的檔複本。

注意

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

另請參閱

適用於