WebBrowser.Navigate Método

Definição

Carrega o documento no local especificado no WebBrowser controle.

Sobrecargas

Nome Description
Navigate(Uri, String, Byte[], String)

Carrega o documento no local indicado pelo especificado Uri no controle, solicitando-o WebBrowser usando os dados HTTP especificados e substituindo o conteúdo do quadro da página da Web pelo nome especificado.

Navigate(String, String, Byte[], String)

Carrega o documento na URL (Uniform Resource Locator) especificada no controle, solicitando-o WebBrowser usando os dados HTTP especificados e substituindo o conteúdo do quadro da página da Web pelo nome especificado.

Navigate(Uri, Boolean)

Carrega o documento no local indicado pelo especificado Uri em uma nova janela do navegador ou no WebBrowser controle.

Navigate(Uri, String)

Carrega o documento no local indicado pelo especificado Uri no WebBrowser controle, substituindo o conteúdo do quadro da 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 WebBrowser controle.

Navigate(String, String)

Carrega o documento na URL (Uniform Resource Locator) especificada no WebBrowser controle, substituindo o conteúdo do quadro da página da Web pelo nome especificado.

Navigate(Uri)

Carrega o documento no local indicado pelo especificado Uri no WebBrowser controle, substituindo o documento anterior.

Navigate(String)

Carrega o documento na URL (Uniform Resource Locator) especificada no WebBrowser controle, substituindo o documento anterior.

Navigate(Uri, String, Byte[], String)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento no local indicado pelo especificado Uri no controle, solicitando-o WebBrowser usando os dados HTTP especificados e substituindo o conteúdo do quadro da 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 ser carregado.

targetFrameName
String

O nome do quadro no qual carregar o documento.

postData
Byte[]

Dados HTTP POST, como dados de formulário.

additionalHeaders
String

Cabeçalhos HTTP a serem adicionados aos cabeçalhos padrão.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser subjacente.

O url valor do parâmetro 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 de 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 estiver 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)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento na URL (Uniform Resource Locator) especificada no controle, solicitando-o WebBrowser usando os dados HTTP especificados e substituindo o conteúdo do quadro da página da Web pelo 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 carregado.

targetFrameName
String

O nome do quadro no qual carregar o documento.

postData
Byte[]

Dados HTTP POST, como dados de formulário.

additionalHeaders
String

Cabeçalhos HTTP a serem adicionados aos cabeçalhos padrão.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser 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 de 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 estiver 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)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento no local indicado pelo especificado Uri em uma nova janela do navegador ou no WebBrowser controle.

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 ser carregado.

newWindow
Boolean

true para carregar o documento em uma nova janela do navegador; false para carregar o documento no WebBrowser controle.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser subjacente.

O url valor do parâmetro 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, falseo 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 valor de parâmetro newWindow de true, o controle WebBrowser carrega o documento no URI especificado em uma nova janela de 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 Internet Explorer separada, o usuário pode recuperar a versão mais recente clicando no botão Refresh.

Confira também

Aplica-se a

Navigate(Uri, String)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento no local indicado pelo especificado Uri no WebBrowser controle, substituindo o conteúdo do quadro da 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 ser carregado.

targetFrameName
String

O nome do quadro no qual carregar o documento.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser subjacente.

O url valor do parâmetro 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 de 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 estiver 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)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento na URL (Uniform Resource Locator) especificada em uma nova janela do navegador ou no WebBrowser controle.

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

newWindow
Boolean

true para carregar o documento em uma nova janela do navegador; false para carregar o documento no WebBrowser controle.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser 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, falseo 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 valor de parâmetro newWindow de true, o controle WebBrowser carrega o documento no URI especificado em uma nova janela de 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 Internet Explorer separada, o usuário pode recuperar a versão mais recente clicando no botão Refresh.

Confira também

Aplica-se a

Navigate(String, String)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento na URL (Uniform Resource Locator) especificada no WebBrowser controle, substituindo o conteúdo do quadro da 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 carregado.

targetFrameName
String

O nome do quadro no qual carregar o documento.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser 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 de 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 estiver 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)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento no local indicado pelo especificado Uri no WebBrowser controle, 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 ser carregado.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser subjacente.

O url valor do parâmetro 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 How to: Add Web Browser Capabilities to a Windows Forms Application.

// 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 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 estiver 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 método Navigate para implementar uma barra de endereços semelhante à de Internet Explorer.

Confira também

Aplica-se a

Navigate(String)

Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs
Origem:
WebBrowser.cs

Carrega o documento na URL (Uniform Resource Locator) especificada no WebBrowser controle, 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 carregado.

Exceções

Essa WebBrowser instância não é mais válida.

Não foi possível recuperar uma referência a uma implementação da IWebBrowser2 interface do controle ActiveX WebBrowser 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 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 estiver 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 método Navigate para implementar uma barra de endereços semelhante à de Internet Explorer.

Confira também

Aplica-se a