WebBrowser.Refresh Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recarrega o documento atualmente exibido no WebBrowser controlo.
Sobrecargas
| Name | Description |
|---|---|
| Refresh() |
Recarrega o documento atualmente exibido no WebBrowser controlo verificando o servidor para uma versão atualizada. |
| Refresh(WebBrowserRefreshOption) |
Recarrega o documento atualmente exibido no WebBrowser controlo usando as opções de atualização especificadas. |
Refresh()
Recarrega o documento atualmente exibido no WebBrowser controlo verificando o servidor para 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 seguinte demonstra como usar o método Refresh para implementar um botão Refresh para o controlo WebBrowser semelhante ao do Internet Explorer. Este exemplo exige que a sua forma contenha um WebBrowser controlo chamado webBrowser1 e um Button controlo chamado ButtonRefresh.
Para o exemplo completo do código, veja Como: Adicionar Capacidades de Navegador Web a uma Aplicação 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
Observações
O WebBrowser controlo armazena páginas Web de sites visitados recentemente numa cache no disco rígido local. Cada página pode especificar uma data de expiração que indique quanto tempo permanecerá na cache. Quando o controlo navega até uma página, poupa tempo ao mostrar uma versão em cache, caso exista disponível, em vez de descarregar a página novamente. O Refresh método obriga o WebBrowser controlo a recarregar a página atual ao descarregá-la, garantindo que o controlo exibe a versão mais recente. Pode usar este método para implementar um botão Refresh semelhante ao do Internet Explorer.
Note
Uma atualização de documento simplesmente recarrega a página atual, por isso os Navigating, , e DocumentCompleted os eventos não ocorrem quando chama o Refresh métodoNavigated.
Ver também
Aplica-se a
Refresh(WebBrowserRefreshOption)
Recarrega o documento atualmente exibido no WebBrowser controlo 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.
Observações
Os WebBrowser guardas de controlo armazenam recentemente páginas Web visitadas numa cache no disco rígido local. Cada página pode especificar uma data de expiração que indique quanto tempo permanecerá na cache. Quando o controlo navega até uma página, poupa tempo ao mostrar uma versão em cache, caso exista disponível, em vez de descarregar a página novamente. O Refresh método força o WebBrowser controlo a recarregar a página atual. O tipo de recarga depende do WebBrowserRefreshOption valor especificado. Se chamar o Refresh método com o WebBrowserRefreshOption.Completely valor, a versão mais recente do documento é descarregada. Se usar o WebBrowserRefreshOption.IfExpired valor, a versão mais recente só é descarregada se o documento atual tiver expirado. Se usar o WebBrowserRefreshOption.Normal valor, o servidor envia uma cópia do documento armazenado na sua própria cache.
Note
Uma atualização de documento simplesmente recarrega a página atual, por isso os Navigating, , e DocumentCompleted os eventos não ocorrem quando chama o Refresh métodoNavigated.