WebBrowser.Navigate 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.
Carrega o documento no local especificado para o controle WebBrowser.
Sobrecargas
Navigate(Uri, String, Byte[], String) |
Carrega o documento no local indicado pelo Uri especificado no controle WebBrowser, solicitando-o usando os dados HTTP especificados e substituindo o conteúdo do quadro de página da Web pelo nome especificado. |
Navigate(String, String, Byte[], String) |
Carrega o documento da URL especificada no controle WebBrowser, solicitando-o usando os dados HTTP especificados e substituindo os conteúdos do quadro de página da Web com o nome especificado. |
Navigate(Uri, Boolean) |
Carrega o documento no local indicado pelo Uri especificado no controle WebBrowser ou em uma nova janela do navegador. |
Navigate(Uri, String) |
Carrega o documento no local indicado pelo Uri especificado no controle WebBrowser, substituindo o conteúdo do quadro de página da Web pelo nome especificado. |
Navigate(String, Boolean) |
Carrega o documento na URL (Uniform Resource Locator) especificada em uma nova janela do navegador ou no controle WebBrowser. |
Navigate(String, String) |
Carrega o documento na URL (Uniform Resource Locator) especificada para o controle WebBrowser, substituindo o conteúdo do quadro de página da Web pelo nome especificado. |
Navigate(Uri) |
Carrega o documento no local indicado pelo GUID Uri no controle WebBrowser, substituindo o documento anterior. |
Navigate(String) |
Carrega o documento da URL (Uniform Resource Locator) especificada no controle WebBrowser, substituindo o documento anterior. |
Navigate(Uri, String, Byte[], String)
Carrega o documento no local indicado pelo Uri especificado no controle WebBrowser, solicitando-o usando os dados HTTP especificados e substituindo o conteúdo do quadro de página da Web pelo nome especificado.
public:
void Navigate(Uri ^ url, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (Uri url, string targetFrameName, byte[] postData, string additionalHeaders);
public void Navigate (Uri? url, string? targetFrameName, byte[]? postData, string? additionalHeaders);
member this.Navigate : Uri * string * byte[] * string -> unit
Public Sub Navigate (url As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)
Parâmetros
- targetFrameName
- String
O nome do quadro no qual o documento será carregado.
- postData
- Byte[]
Dados de POST HTTP como dados de formulário.
- additionalHeaders
- String
Cabeçalhos HTTP a serem adicionados aos cabeçalhos padrão.
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
O valor do parâmetro url
não representa um URI absoluto. Para obter mais informações, consulte IsAbsoluteUri.
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga, o WebBrowser controle carrega o documento no URI especificado no quadro da página da Web com o nome especificado e adiciona o URI ao final da lista de histórico. Se o nome do quadro especificado for inválido, o documento será carregado em uma nova janela do Internet Explorer.
Use o GoBack método para retornar o controle para uma página anterior no histórico de navegação. Use o GoForward método para retornar a uma página posterior no histórico de navegação depois de navegar para trás.
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. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente.
Confira também
Aplica-se a
Navigate(String, String, Byte[], String)
Carrega o documento da URL especificada no controle WebBrowser, solicitando-o usando os dados HTTP especificados e substituindo os conteúdos do quadro de página da Web com o nome especificado.
public:
void Navigate(System::String ^ urlString, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (string urlString, string targetFrameName, byte[] postData, string additionalHeaders);
public void Navigate (string urlString, string? targetFrameName, byte[]? postData, string? additionalHeaders);
member this.Navigate : string * string * byte[] * string -> unit
Public Sub Navigate (urlString As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)
Parâmetros
- urlString
- String
A URL do documento a ser carregada.
- targetFrameName
- String
O nome do quadro no qual o documento será carregado.
- postData
- Byte[]
Dados de POST HTTP como dados de formulário.
- additionalHeaders
- String
Cabeçalhos HTTP a serem adicionados aos cabeçalhos padrão.
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga, o WebBrowser controle carrega o documento no URI especificado no quadro da página da Web com o nome especificado e adiciona o URI ao final da lista de histórico. Se o nome do quadro especificado for inválido, o documento será carregado em uma nova janela do Internet Explorer.
Use o GoBack método para retornar o controle para uma página anterior no histórico de navegação. Use o GoForward método para retornar a uma página posterior no histórico de navegação depois de navegar para trás.
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. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente.
Confira também
Aplica-se a
Navigate(Uri, Boolean)
Carrega o documento no local indicado pelo Uri especificado no controle WebBrowser ou em uma nova janela do navegador.
public:
void Navigate(Uri ^ url, bool newWindow);
public void Navigate (Uri url, bool newWindow);
public void Navigate (Uri? url, bool newWindow);
member this.Navigate : Uri * bool -> unit
Public Sub Navigate (url As Uri, newWindow As Boolean)
Parâmetros
- newWindow
- Boolean
true
para carregar o documento em uma nova janela do navegador; false
para carregar o documento no controle WebBrowser.
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
O valor do parâmetro url
não representa um URI absoluto. Para obter mais informações, consulte IsAbsoluteUri.
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga com um newWindow
valor de parâmetro de false
, o controle navega para o URI especificado normalmente e adiciona o URI ao final da lista de histórico. Quando você chama essa sobrecarga com um newWindow
valor de parâmetro de true
, o WebBrowser controle carrega o documento no URI especificado em uma nova janela do Internet Explorer, que mantém seu próprio histórico de navegação. Você pode manipular o NewWindow evento para receber notificação antes que uma nova janela do navegador seja aberta, permitindo que você cancele a ação, se necessário.
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 até uma página ou carrega uma página em uma janela separada do navegador, ele economiza tempo exibindo uma versão armazenada em cache, se houver uma disponível, em vez de baixar a página novamente. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente. Quando uma página é carregada em uma janela separada do Internet Explorer, o usuário pode recuperar a versão mais recente clicando no botão Atualizar .
Confira também
Aplica-se a
Navigate(Uri, String)
Carrega o documento no local indicado pelo Uri especificado no controle WebBrowser, substituindo o conteúdo do quadro de página da Web pelo nome especificado.
public:
void Navigate(Uri ^ url, System::String ^ targetFrameName);
public void Navigate (Uri url, string targetFrameName);
public void Navigate (Uri? url, string? targetFrameName);
member this.Navigate : Uri * string -> unit
Public Sub Navigate (url As Uri, targetFrameName As String)
Parâmetros
- targetFrameName
- String
O nome do quadro no qual o documento será carregado.
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
O valor do parâmetro url
não representa um URI absoluto. Para obter mais informações, consulte IsAbsoluteUri.
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga, o WebBrowser controle carrega o documento no URI especificado no quadro da página da Web com o nome especificado e adiciona o URI ao final da lista de histórico. Se o nome do quadro especificado for inválido, o documento será carregado em uma nova janela do Internet Explorer.
Use o GoBack método para retornar o controle para uma página anterior no histórico de navegação. Use o GoForward método para retornar a uma página posterior no histórico de navegação depois de navegar para trás.
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. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente.
Confira também
Aplica-se a
Navigate(String, Boolean)
Carrega o documento na URL (Uniform Resource Locator) especificada em uma nova janela do navegador ou no controle WebBrowser.
public:
void Navigate(System::String ^ urlString, bool newWindow);
public void Navigate (string urlString, bool newWindow);
member this.Navigate : string * bool -> unit
Public Sub Navigate (urlString As String, newWindow As Boolean)
Parâmetros
- urlString
- String
A URL do documento a ser carregada.
- newWindow
- Boolean
true
para carregar o documento em uma nova janela do navegador; false
para carregar o documento no controle WebBrowser.
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga com um newWindow
valor de parâmetro de false
, o controle navega para o URI especificado normalmente e adiciona o URI ao final da lista de histórico. Quando você chama essa sobrecarga com um newWindow
valor de parâmetro de true
, o WebBrowser controle carrega o documento no URI especificado em uma nova janela do Internet Explorer, que mantém seu próprio histórico de navegação. Você pode manipular o NewWindow evento para receber notificação antes que uma nova janela do navegador seja aberta, permitindo que você cancele a ação, se necessário.
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 até uma página ou carrega uma página em uma janela separada do navegador, ele economiza tempo exibindo uma versão armazenada em cache, se houver uma disponível, em vez de baixar a página novamente. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente. Quando uma página é carregada em uma janela separada do Internet Explorer, o usuário pode recuperar a versão mais recente clicando no botão Atualizar .
Confira também
Aplica-se a
Navigate(String, String)
Carrega o documento na URL (Uniform Resource Locator) especificada para o controle WebBrowser, substituindo o conteúdo do quadro de página da Web pelo nome especificado.
public:
void Navigate(System::String ^ urlString, System::String ^ targetFrameName);
public void Navigate (string urlString, string targetFrameName);
public void Navigate (string urlString, string? targetFrameName);
member this.Navigate : string * string -> unit
Public Sub Navigate (urlString As String, targetFrameName As String)
Parâmetros
- urlString
- String
A URL do documento a ser carregada.
- targetFrameName
- String
O nome do quadro no qual o documento será carregado.
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga, o WebBrowser controle carrega o documento no URI especificado no quadro da página da Web com o nome especificado e adiciona o URI ao final da lista de histórico. Se o nome do quadro especificado for inválido, o documento será carregado em uma nova janela do Internet Explorer.
Use o GoBack método para retornar o controle a uma página anterior no histórico de navegação. Use o GoForward método para retornar a uma página posterior no histórico de navegação depois de navegar para trás.
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. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente.
Confira também
Aplica-se a
Navigate(Uri)
Carrega o documento no local indicado pelo GUID Uri no controle WebBrowser, substituindo o documento anterior.
public:
void Navigate(Uri ^ url);
public void Navigate (Uri url);
public void Navigate (Uri? url);
member this.Navigate : Uri -> unit
Public Sub Navigate (url As Uri)
Parâmetros
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
O valor do parâmetro url
não representa um URI absoluto. Para obter mais informações, consulte IsAbsoluteUri.
Exemplos
O exemplo de código a seguir demonstra como usar o Navigate método para implementar uma barra de endereços para o WebBrowser controle. Este exemplo requer que seu formulário contenha um WebBrowser controle chamado webBrowser1
, um TextBox controle chamado TextBoxAddress
e um Button controle chamado ButtonGo
. Quando você digita uma URL na caixa de texto e pressiona ENTER ou clica no botão Ir , o WebBrowser controle navega até a URL especificada. Quando você navega clicando em um hiperlink, a caixa de texto é atualizada automaticamente para exibir a URL atual.
Para obter o exemplo de código completo, consulte Como adicionar recursos do navegador da Web a um aplicativo do Windows Forms.
// Navigates to the URL in the address text box when
// the ENTER key is pressed while the text box has focus.
void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
{
if ( e->KeyCode == System::Windows::Forms::Keys::Enter && !this->TextBoxAddress->Text->Equals( "" ) )
{
this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
}
}
// Navigates to the URL in the address text box when
// the Go button is clicked.
void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
if ( !this->TextBoxAddress->Text->Equals( "" ) )
{
this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
}
}
// Updates the URL in TextBoxAddress upon navigation.
void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ )
{
this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString();
}
// Navigates to the URL in the address box when
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
if (e.KeyCode == Keys.Enter)
{
Navigate(toolStripTextBox1.Text);
}
}
// Navigates to the URL in the address box when
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
Navigate(toolStripTextBox1.Text);
}
// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
if (String.IsNullOrEmpty(address)) return;
if (address.Equals("about:blank")) return;
if (!address.StartsWith("http://") &&
!address.StartsWith("https://"))
{
address = "http://" + address;
}
try
{
webBrowser1.Navigate(new Uri(address));
}
catch (System.UriFormatException)
{
return;
}
}
// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
WebBrowserNavigatedEventArgs e)
{
toolStripTextBox1.Text = webBrowser1.Url.ToString();
}
' Navigates to the URL in the address box when
' the ENTER key is pressed while the ToolStripTextBox has focus.
Private Sub toolStripTextBox1_KeyDown( _
ByVal sender As Object, ByVal e As KeyEventArgs) _
Handles toolStripTextBox1.KeyDown
If (e.KeyCode = Keys.Enter) Then
Navigate(toolStripTextBox1.Text)
End If
End Sub
' Navigates to the URL in the address box when
' the Go button is clicked.
Private Sub goButton_Click( _
ByVal sender As Object, ByVal e As EventArgs) _
Handles goButton.Click
Navigate(toolStripTextBox1.Text)
End Sub
' Navigates to the given URL if it is valid.
Private Sub Navigate(ByVal address As String)
If String.IsNullOrEmpty(address) Then Return
If address.Equals("about:blank") Then Return
If Not address.StartsWith("http://") And _
Not address.StartsWith("https://") Then
address = "http://" & address
End If
Try
webBrowser1.Navigate(New Uri(address))
Catch ex As System.UriFormatException
Return
End Try
End Sub
' Updates the URL in TextBoxAddress upon navigation.
Private Sub webBrowser1_Navigated(ByVal sender As Object, _
ByVal e As WebBrowserNavigatedEventArgs) _
Handles webBrowser1.Navigated
toolStripTextBox1.Text = webBrowser1.Url.ToString()
End Sub
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga, o WebBrowser controle navega até o URI especificado e o adiciona ao final da lista de histórico. Use o GoBack método para retornar o controle a uma página anterior no histórico de navegação. Use o GoForward método para retornar a uma página posterior no histórico de navegação depois de navegar para trás.
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. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente.
Você pode usar o Navigate método para implementar uma barra de endereços semelhante à do Internet Explorer.
Confira também
Aplica-se a
Navigate(String)
Carrega o documento da URL (Uniform Resource Locator) especificada no controle WebBrowser, substituindo o documento anterior.
public:
void Navigate(System::String ^ urlString);
public void Navigate (string urlString);
member this.Navigate : string -> unit
Public Sub Navigate (urlString As String)
Parâmetros
- urlString
- String
A URL do documento a ser carregada.
Exceções
Essa instância WebBrowser não é mais válida.
Uma referência a uma implementação da interface IWebBrowser2
não pôde ser recuperada do controle WebBrowser
do ActiveX subjacente.
Comentários
O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. Quando você chama essa sobrecarga, o WebBrowser controle navega até o URI especificado e o adiciona ao final da lista de histórico. Use o GoBack método para retornar o controle a uma página anterior no histórico de navegação. Use o GoForward método para retornar a uma página posterior no histórico de navegação depois de navegar para trás.
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. Use o Refresh método para forçar o WebBrowser controle a recarregar a página atual baixando-a, garantindo que o controle exiba a versão mais recente.
Você pode usar o Navigate método para implementar uma barra de endereços semelhante à do Internet Explorer.