Compartilhar via

WebBrowser.Navigate Método

  • Referência

Definição

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

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

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