WebBrowser.Refresh Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Перезагрузит документ, отображаемый в данный момент в элементе WebBrowser управления.

Перегрузки

Имя	Описание
Refresh()	Перезагрузит документ, отображаемый в элементе WebBrowser управления, проверив сервер для обновленной версии.
Refresh(WebBrowserRefreshOption)	Перезагрузит документ, отображаемый в элементе WebBrowser управления, с помощью указанных параметров обновления.

Refresh()

Исходный код:

WebBrowser.cs

Перезагрузит документ, отображаемый в элементе WebBrowser управления, проверив сервер для обновленной версии.

public:
 override void Refresh();

public override void Refresh();

override this.Refresh : unit -> unit

Public Overrides Sub Refresh ()

Примеры

В следующем примере кода показано, как использовать метод Refresh для реализации кнопки Refresh для элемента управления WebBrowser аналогично элементу управления в Internet Explorer. В этом примере требуется, чтобы форма содержала WebBrowser элемент управления с именем webBrowser1 и Button элементом ButtonRefreshуправления.

Полный пример кода см. в разделе How to: Add Web Browser Capabilities to a Windows Forms Application.

// 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 элемент управления перезагрузить текущую страницу, скачав его, чтобы элемент управления отображал последнюю версию. Этот метод можно использовать для реализации кнопки Refresh аналогичной кнопке в Internet Explorer.

Note

Обновление документа просто перезагрузит текущую страницу, поэтому NavigatingNavigatedсобытия и DocumentCompleted события не происходят при вызове Refresh метода.

См. также раздел

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

Refresh(WebBrowserRefreshOption)

Исходный код:

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)

Параметры

opt

WebBrowserRefreshOption

Одно из значений WebBrowserRefreshOption .

Комментарии

Элемент WebBrowser управления хранит недавно посещаемые веб-страницы в кэше на локальном жестком диске. Каждая страница может указать дату окончания срока действия, указывающую, сколько времени она останется в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию, если она доступна, а не скачивание страницы снова. Метод Refresh заставляет WebBrowser элемент управления перезагрузить текущую страницу. Тип перезагрузки зависит от указанного WebBrowserRefreshOption значения. При вызове Refresh метода со WebBrowserRefreshOption.Completely значением загружается последняя версия документа. Если используется WebBrowserRefreshOption.IfExpired значение, последняя версия скачается только в том случае, если истек срок действия текущего документа. При использовании WebBrowserRefreshOption.Normal значения сервер отправляет копию документа, хранящегося в собственном кэше.

Note

Обновление документа просто перезагрузит текущую страницу, поэтому NavigatingNavigatedсобытия и DocumentCompleted события не происходят при вызове Refresh метода.

См. также раздел

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