WebBrowser.Navigate Método

Definição

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

url
Uri

Um Uri que representa a URL do documento a carregar.

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

url
Uri

Um Uri que representa a URL do documento a carregar.

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

url
Uri

Um Uri que representa a URL do documento a carregar.

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

url
Uri

Um Uri que representa a URL do documento a carregar.

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 TextBoxAddresse 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.

Confira também

Aplica-se a