WebBrowser.Refresh Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recarrega o documento exibido no momento no WebBrowser controle.
Sobrecargas
| Nome | Description |
|---|---|
| Refresh() |
Recarrega o documento exibido atualmente no WebBrowser controle verificando o servidor para obter uma versão atualizada. |
| Refresh(WebBrowserRefreshOption) |
Recarrega o documento exibido atualmente no WebBrowser controle usando as opções de atualização especificadas. |
Refresh()
Recarrega o documento exibido atualmente no WebBrowser controle verificando o servidor para obter uma versão atualizada.
public:
override void Refresh();
public override void Refresh();
override this.Refresh : unit -> unit
Public Overrides Sub Refresh ()
Exemplos
O exemplo de código a seguir demonstra como usar o método Refresh para implementar um botão Refresh para o controle WebBrowser semelhante ao de Internet Explorer. Este exemplo requer que seu formulário contenha um WebBrowser controle chamado webBrowser1 e um Button controle chamado ButtonRefresh.
Para obter o exemplo de código completo, consulte 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
Comentários
O WebBrowser controle armazena páginas da Web de sites visitados recentemente em um cache no disco rígido local. Cada página pode especificar uma data de validade indicando quanto tempo permanecerá no cache. Quando o controle navega para uma página, ele economiza tempo exibindo uma versão armazenada em cache, se estiver disponível, em vez de baixar a página novamente. O Refresh método força o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente. Você pode usar esse método para implementar um botão Refresh semelhante ao de Internet Explorer.
Note
Uma atualização de documento simplesmente recarrega a página atual, de modo que os NavigatingNavigatedeventos e DocumentCompleted os eventos não ocorram quando você chama o Refresh método.
Confira também
Aplica-se a
Refresh(WebBrowserRefreshOption)
Recarrega o documento exibido atualmente no WebBrowser controle usando as opções de atualização especificadas.
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)
Parâmetros
Um dos WebBrowserRefreshOption valores.
Comentários
O WebBrowser controle armazena páginas da Web visitadas recentemente em um cache no disco rígido local. Cada página pode especificar uma data de validade indicando quanto tempo permanecerá no cache. Quando o controle navega para uma página, ele economiza tempo exibindo uma versão armazenada em cache, se estiver disponível, em vez de baixar a página novamente. O Refresh método força o WebBrowser controle a recarregar a página atual. O tipo de recarregamento depende do WebBrowserRefreshOption valor especificado. Se você chamar o Refresh método com o WebBrowserRefreshOption.Completely valor, a versão mais recente do documento será baixada. Se você usar o WebBrowserRefreshOption.IfExpired valor, a versão mais recente será baixada somente se o documento atual tiver expirado. Se você usar o WebBrowserRefreshOption.Normal valor, o servidor enviará uma cópia do documento armazenado em seu próprio cache.
Note
Uma atualização de documento simplesmente recarrega a página atual, de modo que os NavigatingNavigatedeventos e DocumentCompleted os eventos não ocorram quando você chama o Refresh método.