WebBrowser.Refresh メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
WebBrowser コントロールに現在表示されているドキュメントを再読み込みします。
オーバーロード
| 名前 | 説明 |
|---|---|
| Refresh() |
サーバーで更新されたバージョンを確認して、 WebBrowser コントロールに現在表示されているドキュメントを再読み込みします。 |
| Refresh(WebBrowserRefreshOption) |
指定した更新オプションを使用して、 WebBrowser コントロールに現在表示されているドキュメントを再読み込みします。 |
Refresh()
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
サーバーで更新されたバージョンを確認して、 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 コントロールが含まれている必要があります。
完全なコード例については、「方法: Web ブラウザー機能を Windows フォーム アプリケーションに追加するを参照してください。
// 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 コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。 このメソッドを使用して、Refresh ボタンを実装Internet Explorer。
Note
ドキュメントの更新では現在のページが再読み込みされるだけなので、Navigating メソッドを呼び出すときにNavigated、DocumentCompleted、Refreshイベントは発生しません。
こちらもご覧ください
適用対象
Refresh(WebBrowserRefreshOption)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した更新オプションを使用して、 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)
パラメーター
WebBrowserRefreshOption値の 1 つ。
注釈
WebBrowser コントロールは、最近アクセスした Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードするのではなく、時間を節約できます。 Refresh メソッドは、WebBrowser コントロールに現在のページの再読み込みを強制します。 再読み込みの種類は、指定された WebBrowserRefreshOption 値によって異なります。 Refresh値を使用して WebBrowserRefreshOption.Completely メソッドを呼び出すと、ドキュメントの最新バージョンがダウンロードされます。 WebBrowserRefreshOption.IfExpired値を使用する場合、最新バージョンは、現在のドキュメントの有効期限が切れている場合にのみダウンロードされます。 WebBrowserRefreshOption.Normal値を使用すると、サーバーは独自のキャッシュに格納されているドキュメントのコピーを送信します。
Note
ドキュメントの更新では現在のページが再読み込みされるだけなので、Navigating メソッドを呼び出すときにNavigated、DocumentCompleted、Refreshイベントは発生しません。