WebBrowser.Navigate Método

Referência

Definição

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Navega de forma assíncrona para o documento na Uri especificada.

Sobrecargas

Navigate(String, String, Byte[], String)	Navegue de forma assíncrona para o documento na URL especificada e especifique o quadro alvo para carregar o conteúdo do documento. Dados adicionais do HTTP POST 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 no documento no Uri especificado e especifique o quadro de destino no qual carregar o conteúdo do documento. Dados adicionais do HTTP POST e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação de navegação.
Navigate(String)	Navega de forma assíncrona para o documento na URL especificada.
Navigate(Uri)	Navega de forma assíncrona para o documento na Uri especificada.

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

Navegue de forma assíncrona para o documento na URL especificada e especifique o quadro alvo para carregar o conteúdo do documento. Dados adicionais do HTTP POST 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 até a qual navegar.

targetFrameName: String

O nome do quadro para exibir o conteúdo do documento.

postData: Byte[]

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

additionalHeaders: String

Cabeçalhos de 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 no documento no Uri especificado e especifique o quadro de destino no qual carregar o conteúdo do documento. Dados adicionais do HTTP POST 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

A Uri até a qual navegar.

targetFrameName: String

O nome do quadro para exibir o conteúdo do documento.

postData: Byte[]

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

additionalHeaders: String

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

Exceções

ObjectDisposedException

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

InvalidOperationException

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

SecurityException

Navegação de um aplicativo que está sendo executado em confiança parcial:

Para um Uri que não está localizado no site de origem ou O nome de
targetFrameName não é null ou 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

Aplica-se a

Navigate(String)

Navega de forma assíncrona para 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 até 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)

Navega de forma assíncrona para o documento na Uri especificada.

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

A Uri até a qual navegar.

Exceções

ObjectDisposedException

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

InvalidOperationException

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

SecurityException

Navegação de um aplicativo que está sendo executado em confiança parcial para um Uri que não está localizado no site 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 na 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

WebBrowser.Navigate Método

Definição

Sobrecargas

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

Parâmetros

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Navigate(String)

Parâmetros

Comentários

Aplica-se a

Navigate(Uri)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Recursos adicionais