Compartilhar via

WebBrowser.Navigate Método

Definição

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Navegue de forma assíncrona até o documento no especificado Uri.

Sobrecargas

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

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

Navegue de forma assíncrona até o documento no especificado Uri e especifique o quadro de destino para o qual carregar o conteúdo do documento. Dados HTTP POST adicionais e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação de navegação.
Navigate(String)

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

Navegue de forma assíncrona até o documento no especificado Uri.

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

Navega de forma assíncrona até o documento na URL especificada e especifica o quadro de destino para o qual carregar o conteúdo do documento. Dados HTTP POST adicionais e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação 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

A URL para a qual navegar.

targetFrameName
String

O nome do quadro no qual exibir o conteúdo do documento.

postData
Byte[]

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

additionalHeaders
String

Cabeçalhos HTTP para enviar ao servidor quando a origem é solicitada.

Comentários

Use o Navigate(String, String, Byte[], String) método para navegar até uma URL que pode 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 de forma assíncrona até o documento no especificado Uri e especifique o quadro de destino para o qual carregar o conteúdo do documento. Dados HTTP POST adicionais e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação 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 o qual navegar.

targetFrameName
String

O nome do quadro no qual exibir o conteúdo do documento.

postData
Byte[]

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

additionalHeaders
String

Cabeçalhos HTTP para enviar ao servidor quando a origem é solicitada.

Exceções

ObjectDisposedException

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

InvalidOperationException

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

SecurityException

Navegação de um aplicativo em execução em confiança parcial:

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

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

Exemplos

O exemplo a seguir mostra como navegar até um documento e abri-lo em uma nova janela do navegador especificando o destino "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);
}

Comentários

Use o Navigate(String, String, Byte[], String) método para navegar até uma URL que pode 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é o 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

A URL para a qual navegar.

Comentários

Use o Navigate(String) método para navegar até uma URL que pode 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 de forma assíncrona até o documento no especificado 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 o qual navegar.

Exceções

ObjectDisposedException

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

InvalidOperationException

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

SecurityException

Navegação de um aplicativo que está em execução em confiança parcial para um Uri que não está localizado no local de origem.

Exemplos

O exemplo a seguir mostra como usar WebBrowser para navegar até um documento usando 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);
}

Comentários

A chamada Navigate(Uri) tem o mesmo efeito que definir a Source propriedade. Source é usado da marcação por desenvolvedores que desejam especificar declarativamente o documento inicial que WebBrowser navega até quando WebBrowser é inicializado.

Use o Navigate(String) método para navegar até uma URL que pode 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