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を実装する方法を示します。 この例では、フォームに というコントロールと というコントロールwebBrowser1ButtonButtonRefresh含まれているWebBrowser必要があります。

完全なコード例については、「方法: 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 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) が表示され、ページをもう一度ダウンロードするのではなく、時間が節約されます。 メソッドは Refresh 、コントロールを WebBrowser ダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。 このメソッドを使用して、インターネット エクスプローラーのものと同様の [更新] ボタンを実装できます。

注意

ドキュメントの更新では、現在のページが再読み込みされるため、 メソッドをNavigatingNavigated呼び出すときに、、、 DocumentCompleted イベントはRefresh発生しません。

こちらもご覧ください

適用対象

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 値のいずれか 1 つ。

注釈

コントロールは WebBrowser 、最近アクセスした Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) が表示され、ページをもう一度ダウンロードするのではなく、時間が節約されます。 メソッドは Refresh 、コントロールに現在の WebBrowser ページの再読み込みを強制します。 再読み込みの種類は、指定された WebBrowserRefreshOption 値によって異なります。 値を指定して メソッドをRefreshWebBrowserRefreshOption.Completely呼び出すと、ドキュメントの最新バージョンがダウンロードされます。 値を WebBrowserRefreshOption.IfExpired 使用すると、現在のドキュメントの有効期限が切れている場合にのみ、最新バージョンがダウンロードされます。 値を WebBrowserRefreshOption.Normal 使用すると、サーバーは独自のキャッシュに格納されているドキュメントのコピーを送信します。

注意

ドキュメントの更新では、現在のページが再読み込みされるため、 メソッドをNavigatingNavigated呼び出すときに、、、 DocumentCompleted イベントはRefresh発生しません。

こちらもご覧ください

適用対象