WebBrowser.Navigate Método

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);

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

Exceções

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando se chama a isto overload, o controlo WebBrowser carrega o documento no URI especificado no frame da página Web com o nome especificado, e adiciona o URI ao final da lista de histórico. Se o nome do frame especificado for inválido, o documento é carregado numa nova janela do Internet Explorer.

Use o GoBack método para devolver o controlo a uma página anterior no histórico de navegação. Use o GoForward método para voltar a uma página posterior no histórico de navegação depois de navegar para trás.

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. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente.

Ver também

• GoBack()
• GoForward()
• Refresh()
• Controle WebBrowser
• IWebBrowser2 Interface

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);

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

Exceções

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando se chama a isto overload, o controlo WebBrowser carrega o documento no URI especificado no frame da página Web com o nome especificado, e adiciona o URI ao final da lista de histórico. Se o nome do frame especificado for inválido, o documento é carregado numa nova janela do Internet Explorer.

Use o GoBack método para devolver o controlo a uma página anterior no histórico de navegação. Use o GoForward método para voltar a uma página posterior no histórico de navegação depois de navegar para trás.

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. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente.

Ver também

• GoBack()
• GoForward()
• Refresh()
• Controle WebBrowser
• IWebBrowser2 Interface

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

Exceções

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando se chama a esta sobrecarga com um newWindow valor de parâmetro de false, o controlo navega normalmente até ao URI especificado e adiciona o URI ao final da lista de histórico. Quando se chama a esta sobrecarga com um valor de parâmetro newWindow de true, o controlo WebBrowser carrega o documento no URI especificado numa nova janela de Internet Explorer, que mantém o seu próprio histórico de navegação. Pode gerir o NewWindow evento para receber notificações antes de abrir uma nova janela do navegador, permitindo-lhe cancelar a ação se necessário.

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 ou carrega uma página numa janela separada do navegador, poupa tempo ao mostrar uma versão em cache, caso exista disponível, em vez de descarregar a página novamente. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente. Quando uma página é carregada numa janela Internet Explorer separada, o utilizador pode recuperar a versão mais recente clicando no botão Refresh.

Ver também

• GoBack()
• GoForward()
• NewWindow
• Refresh()
• Controle WebBrowser
• IWebBrowser2 Interface

public:
 void Navigate(Uri ^ url, System::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

Exceções

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando se chama a isto overload, o controlo WebBrowser carrega o documento no URI especificado no frame da página Web com o nome especificado, e adiciona o URI ao final da lista de histórico. Se o nome do frame especificado for inválido, o documento é carregado numa nova janela do Internet Explorer.

Use o GoBack método para devolver o controlo a uma página anterior no histórico de navegação. Use o GoForward método para voltar a uma página posterior no histórico de navegação depois de navegar para trás.

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. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente.

Ver também

• GoBack()
• GoForward()
• Refresh()
• Controle WebBrowser
• IWebBrowser2 Interface

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

Exceções

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando se chama a esta sobrecarga com um newWindow valor de parâmetro de false, o controlo navega normalmente até ao URI especificado e adiciona o URI ao final da lista de histórico. Quando se chama a esta sobrecarga com um valor de parâmetro newWindow de true, o controlo WebBrowser carrega o documento no URI especificado numa nova janela de Internet Explorer, que mantém o seu próprio histórico de navegação. Pode gerir o NewWindow evento para receber notificações antes de abrir uma nova janela do navegador, permitindo-lhe cancelar a ação se necessário.

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 ou carrega uma página numa janela separada do navegador, poupa tempo ao mostrar uma versão em cache, caso exista disponível, em vez de descarregar a página novamente. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente. Quando uma página é carregada numa janela Internet Explorer separada, o utilizador pode recuperar a versão mais recente clicando no botão Refresh.

Ver também

• GoBack()
• GoForward()
• NewWindow
• Refresh()

public:
 void Navigate(System::String ^ urlString, System::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

Exceções

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando se chama a isto overload, o controlo WebBrowser carrega o documento no URI especificado no frame da página Web com o nome especificado, e adiciona o URI ao final da lista de histórico. Se o nome do frame especificado for inválido, o documento é carregado numa nova janela do Internet Explorer.

Use o GoBack método para devolver o controlo a uma página anterior no histórico de navegação. Use o GoForward método para voltar a uma página posterior no histórico de navegação depois de navegar para trás.

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. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente.

Ver também

• GoBack()
• GoForward()
• Refresh()
• Controle WebBrowser
• IWebBrowser2 Interface

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

Exemplos

O exemplo de código seguinte demonstra como usar o Navigate método para implementar uma barra de endereços para o WebBrowser controlo. Este exemplo exige que a sua forma contenha um WebBrowser controlo chamado webBrowser1, um TextBox controlo chamado TextBoxAddress, e um Button controlo chamado ButtonGo. Quando escreve um URL na caixa de texto e pressiona ENTER ou clica no botão Go , o controlo WebBrowser navega até ao URL especificado. Quando navega clicando num hiperlink, a caixa de texto atualiza-se automaticamente para mostrar o URL atual.

Para o exemplo completo do código, veja Como: Adicionar Capacidades de Navegador Web a uma Aplicação 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

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando chamas a isto overload, o WebBrowser controlo navega até ao URI especificado e adiciona-o ao final da lista de histórico. Use o GoBack método para devolver o controlo a uma página anterior no histórico de navegação. Use o GoForward método para voltar a uma página posterior no histórico de navegação depois de navegar para trás.

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. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente.

Pode usar o método Navigate para implementar uma barra de endereços semelhante à do Internet Explorer.

Ver também

• GoBack()
• GoForward()
• Refresh()
• Controle WebBrowser
• IWebBrowser2 Interface

public:
 void Navigate(System::String ^ urlString);

public void Navigate(string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

Parâmetros

Exceções

Observações

O WebBrowser controlo mantém uma lista de histórico de todas as páginas Web visitadas durante uma sessão de navegação. Quando chamas a isto overload, o WebBrowser controlo navega até ao URI especificado e adiciona-o ao final da lista de histórico. Use o GoBack método para devolver o controlo a uma página anterior no histórico de navegação. Use o GoForward método para voltar a uma página posterior no histórico de navegação depois de navegar para trás.

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. Use o Refresh método para forçar o WebBrowser controlo a recarregar a página atual descarregando-a, garantindo que o controlo mostra a versão mais recente.

Pode usar o método Navigate para implementar uma barra de endereços semelhante à do Internet Explorer.

Ver também

• GoBack()
• GoForward()
• Refresh()
• Controle WebBrowser
• IWebBrowser2 Interface