WebBrowser.Refresh Método

Definição

Recarrega o documento exibido atualmente no controle WebBrowser.

Sobrecargas

Refresh()

Recarrega o documento exibido no momento no controle WebBrowser, verificando se há uma versão atualizada para o servidor.

Refresh(WebBrowserRefreshOption)

Recarrega o documento exibido no momento no controle WebBrowser usando as opções de atualização especificadas.

Refresh()

Recarrega o documento exibido no momento no controle WebBrowser, verificando se há uma versão atualizada para o servidor.

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 Refresh método para implementar um botão Atualizar para o WebBrowser controle semelhante ao da 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 Como adicionar recursos do navegador da Web a um aplicativo 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

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 houver uma 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 Atualizar semelhante ao da Internet Explorer.

Observação

Uma atualização de documento simplesmente recarrega a página atual, para que os Navigatingeventos , Navigatede DocumentCompleted não ocorram quando você chama o Refresh método .

Confira também

Aplica-se a

Refresh(WebBrowserRefreshOption)

Recarrega o documento exibido no momento no controle WebBrowser 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

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 houver uma 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.

Observação

Uma atualização de documento simplesmente recarrega a página atual, para que os Navigatingeventos , Navigatede DocumentCompleted não ocorram quando você chama o Refresh método .

Confira também

Aplica-se a