WebBrowser.Refresh Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Memuat ulang dokumen yang saat ini ditampilkan dalam WebBrowser kontrol.
Overload
Refresh() |
Memuat ulang dokumen yang saat ini ditampilkan dalam WebBrowser kontrol dengan memeriksa server untuk versi yang diperbarui. |
Refresh(WebBrowserRefreshOption) |
Memuat ulang dokumen yang saat ini ditampilkan dalam WebBrowser kontrol menggunakan opsi refresh yang ditentukan. |
Refresh()
Memuat ulang dokumen yang saat ini ditampilkan dalam WebBrowser kontrol dengan memeriksa server untuk versi yang diperbarui.
public:
override void Refresh();
public override void Refresh ();
override this.Refresh : unit -> unit
Public Overrides Sub Refresh ()
Contoh
Contoh kode berikut menunjukkan cara menggunakan Refresh metode untuk mengimplementasikan tombol Refresh untuk WebBrowser kontrol yang mirip dengan yang ada di Internet Explorer. Contoh ini mengharuskan formulir Anda berisi kontrol yang WebBrowser disebut webBrowser1
dan kontrol yang Button disebut ButtonRefresh
.
Untuk contoh kode lengkap, lihat Cara: Menambahkan Kemampuan Browser Web ke Aplikasi Formulir 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
Keterangan
Kontrol WebBrowser menyimpan halaman Web dari situs yang baru-baru ini dikunjungi dalam singgahan pada hard disk lokal. Setiap halaman dapat menentukan tanggal kedaluwarsa yang menunjukkan berapa lama akan tetap berada di cache. Saat kontrol menavigasi ke halaman, kontrol menghemat waktu dengan menampilkan versi yang di-cache, jika tersedia, daripada mengunduh halaman lagi. Metode memaksa RefreshWebBrowser kontrol untuk memuat ulang halaman saat ini dengan mengunduhnya, memastikan bahwa kontrol menampilkan versi terbaru. Anda dapat menggunakan metode ini untuk mengimplementasikan tombol Refresh yang mirip dengan yang ada di Internet Explorer.
Catatan
Refresh dokumen hanya memuat ulang halaman saat ini, sehingga Navigatingperistiwa , Navigated, dan DocumentCompleted tidak terjadi saat Anda memanggil Refresh metode .
Lihat juga
Berlaku untuk
Refresh(WebBrowserRefreshOption)
Memuat ulang dokumen yang saat ini ditampilkan dalam WebBrowser kontrol menggunakan opsi refresh yang ditentukan.
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)
Parameter
Salah WebBrowserRefreshOption satu nilai.
Keterangan
Kontrol WebBrowser menyimpan halaman Web yang baru-baru ini dikunjungi dalam cache pada hard disk lokal. Setiap halaman dapat menentukan tanggal kedaluwarsa yang menunjukkan berapa lama akan tetap berada di cache. Saat kontrol menavigasi ke halaman, kontrol menghemat waktu dengan menampilkan versi yang di-cache, jika tersedia, daripada mengunduh halaman lagi. Metode memaksa RefreshWebBrowser kontrol untuk memuat ulang halaman saat ini. Jenis isi ulang tergantung pada nilai yang WebBrowserRefreshOption ditentukan. Jika Anda memanggil Refresh metode dengan WebBrowserRefreshOption.Completely nilai , versi terbaru dokumen diunduh. Jika Anda menggunakan WebBrowserRefreshOption.IfExpired nilai , versi terbaru diunduh hanya jika dokumen saat ini telah kedaluwarsa. Jika Anda menggunakan nilai , WebBrowserRefreshOption.Normal server mengirim salinan dokumen yang disimpan dalam cache-nya sendiri.
Catatan
Refresh dokumen hanya memuat ulang halaman saat ini, sehingga Navigatingperistiwa , Navigated, dan DocumentCompleted tidak terjadi saat Anda memanggil Refresh metode .