WebBrowser.Refresh Метод

Определение

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

Перегрузки

Refresh()

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

Refresh(WebBrowserRefreshOption)

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

Refresh()

Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs

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

public override void Refresh ();

Примеры

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

Полный пример кода см. в разделе Практическое руководство. Добавление возможностей веб-браузера в приложение Windows Forms.

// 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();
    }
}

Комментарии

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

Примечание

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

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

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Refresh(WebBrowserRefreshOption)

Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs

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

public void Refresh (System.Windows.Forms.WebBrowserRefreshOption opt);

Параметры

opt
WebBrowserRefreshOption

Одно из значений перечисления WebBrowserRefreshOption.

Комментарии

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

Примечание

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

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

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9