WebBrowser.Navigate Método

Definição

Espaço de Nomes:
System.Windows.Controls
Assemblagem:
PresentationFramework.dll

Navegue assíncronamente até ao documento na ficha especificada Uri.

Sobrecargas

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

Navega de forma assíncrona até ao documento na URL especificada e especifica o frame-alvo onde carregar o conteúdo do documento. Dados HTTP POST adicionais e cabeçalhos HTTP podem ser enviados para o servidor como parte do pedido de navegação.
Navigate(Uri, String, Byte[], String)

Navegue assíncronamente até ao documento no especificado Uri e especifique o frame-alvo onde carregar o conteúdo do documento. Dados HTTP POST adicionais e cabeçalhos HTTP podem ser enviados para o servidor como parte do pedido de navegação.
Navigate(String)

Navega de forma assíncrona até ao documento na URL especificada.
Navigate(Uri)

Navegue assíncronamente até ao documento na ficha especificada Uri.

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

Navega de forma assíncrona até ao documento na URL especificada e especifica o frame-alvo onde carregar o conteúdo do documento. Dados HTTP POST adicionais e cabeçalhos HTTP podem ser enviados para o servidor como parte do pedido de navegação.

public:
 void Navigate(System::String ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate(string source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : string * string * byte[] * string -> unit
Public Sub Navigate (source As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parâmetros

source
String

O URL para o qual navegar.

targetFrameName
String

O nome da moldura onde se deve exibir o conteúdo do documento.

postData
Byte[]

Dados HTTP POST para enviar ao servidor quando a fonte for solicitada.

additionalHeaders
String

Cabeçalhos HTTP para enviar ao servidor quando a fonte for solicitada.

Observações

Use o Navigate(String, String, Byte[], String) método para navegar até uma URL que possa incluir caracteres de escape. Use o Navigate(Uri, String, Byte[], String) método para navegar até um Uri que não inclua caracteres de escape.

Aplica-se a

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

Navegue assíncronamente até ao documento no especificado Uri e especifique o frame-alvo onde carregar o conteúdo do documento. Dados HTTP POST adicionais e cabeçalhos HTTP podem ser enviados para o servidor como parte do pedido de navegação.

public:
 void Navigate(Uri ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate(Uri source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : Uri * string * byte[] * string -> unit
Public Sub Navigate (source As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parâmetros

source
Uri

O Uri para navegar.

targetFrameName
String

O nome da moldura onde se deve exibir o conteúdo do documento.

postData
Byte[]

Dados HTTP POST para enviar ao servidor quando a fonte for solicitada.

additionalHeaders
String

Cabeçalhos HTTP para enviar ao servidor quando a fonte for solicitada.

Exceções

ObjectDisposedException

A WebBrowser instância já não é válida.

InvalidOperationException

Não foi possível recuperar uma referência ao nativo WebBrowser subjacente.

SecurityException

Navegação a partir de uma aplicação que está a correr em confiança parcial:

  • Para um Uri que não está localizado no local de origem, ou

  • targetFrameName O nome não null é ou está vazio.

Exemplos

O exemplo seguinte mostra como navegar até um documento e abri-lo numa nova janela do navegador, especificando o alvo "about:blank".

<StackPanel>
    <StackPanel Orientation="Horizontal">
        <TextBox x:Name="addressTextBox" Width="200" />
        <Button Click="goNavigateButton_Click">Go</Button>
    </StackPanel>
    <WebBrowser x:Name="myWebBrowser" />
</StackPanel>

private void goNavigateButton_Click(object sender, RoutedEventArgs e)
{
    // Get URI to navigate to
    Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);

    // Only absolute URIs can be navigated to
    if (!uri.IsAbsoluteUri)
    {
        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");
        return;
    }

    // Navigate to the desired URL by calling the .Navigate method
    this.myWebBrowser.Navigate(uri, "_blank", null, null);
}

Observações

Use o Navigate(String, String, Byte[], String) método para navegar até uma URL que possa incluir caracteres de escape. Use o Navigate(Uri, String, Byte[], String) método para navegar até um Uri que não inclua caracteres de escape.

Aplica-se a

Navigate(String)

Navega de forma assíncrona até ao documento na URL especificada.

public:
 void Navigate(System::String ^ source);
public void Navigate(string source);
member this.Navigate : string -> unit
Public Sub Navigate (source As String)

Parâmetros

source
String

O URL para o qual navegar.

Observações

Use o Navigate(String) método para navegar até uma URL que possa incluir caracteres de escape. Use o Navigate(Uri) método para navegar até um Uri que não inclua caracteres de escape.

Aplica-se a

Navigate(Uri)

Navegue assíncronamente até ao documento na ficha especificada Uri.

public:
 void Navigate(Uri ^ source);
public void Navigate(Uri source);
member this.Navigate : Uri -> unit
Public Sub Navigate (source As Uri)

Parâmetros

source
Uri

O Uri para navegar.

Exceções

ObjectDisposedException

A WebBrowser instância já não é válida.

InvalidOperationException

Não foi possível recuperar uma referência ao nativo WebBrowser subjacente.

SecurityException

Navegação de uma aplicação que está a correr em confiança parcial para uma Uri que não está localizada no local de origem.

Exemplos

O exemplo seguinte mostra como navegar WebBrowser até um documento utilizando o Navigate(Uri) método.

<StackPanel>
    <StackPanel Orientation="Horizontal">
        <TextBox x:Name="addressTextBox" Width="200" />
        <Button Click="goNavigateButton_Click">Go</Button>
    </StackPanel>
    <WebBrowser x:Name="myWebBrowser" />
</StackPanel>

private void goNavigateButton_Click(object sender, RoutedEventArgs e)
{
    // Get URI to navigate to
    Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);

    // Only absolute URIs can be navigated to
    if (!uri.IsAbsoluteUri)
    {
        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");
        return;
    }

    // Navigate to the desired URL by calling the .Navigate method
    this.myWebBrowser.Navigate(uri);
}

Observações

Ligar Navigate(Uri) tem o mesmo efeito que definir a Source propriedade. Source é usado a partir da marcação por programadores que querem especificar declarativamente o documento inicial que WebBrowser navega até quando WebBrowser é inicializado.

Use o Navigate(String) método para navegar até uma URL que possa incluir caracteres de escape. Use o Navigate(Uri) método para navegar até um Uri que não inclua caracteres de escape.

Aplica-se a