WebBrowser.Refresh Метод

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Примечание

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

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

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

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.

Комментарии

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

Примечание

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

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

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