WebBrowser.Navigate Método

Definição

Navega de forma assíncrona para o documento na Uri especificada.Navigate asynchronously to the document at the specified Uri.

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.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. Dados adicionais do HTTP POST e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação de navegação.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. Dados adicionais do HTTP POST e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação de navegação.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

Navigate(String)

Navega de forma assíncrona para o documento na URL especificada.Navigates asynchronously to the document at the specified URL.

Navigate(Uri)

Navega de forma assíncrona para o documento na Uri especificada.Navigate asynchronously to the document at the specified Uri.

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.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. Dados adicionais do HTTP POST e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação de navegação.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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.The URL to navigate to.

targetFrameName
String

O nome do quadro para exibir o conteúdo do documento.The name of the frame to display the document's content in.

postData
Byte[]

Dados de HTTP POST para enviar ao servidor quando a origem é solicitada.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String

Cabeçalhos de HTTP para enviar ao servidor quando a origem é solicitada.HTTP headers to send to the server when the source is requested.

Comentários

Use o método Navigate(String, String, Byte[], String) para navegar até uma URL que pode incluir caracteres de escape.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Use o método Navigate(Uri, String, Byte[], String) para navegar até uma Uri que não inclua caracteres de escape.Use the Navigate(Uri, String, Byte[], String) method to navigate to a Uri that does not include escape characters.

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.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. Dados adicionais do HTTP POST e cabeçalhos HTTP podem ser enviados ao servidor como parte da solicitação de navegação.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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.The Uri to navigate to.

targetFrameName
String

O nome do quadro para exibir o conteúdo do documento.The name of the frame to display the document's content in.

postData
Byte[]

Dados de HTTP POST para enviar ao servidor quando a origem é solicitada.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String

Cabeçalhos de HTTP para enviar ao servidor quando a origem é solicitada.HTTP headers to send to the server when the source is requested.

Exceções

A instância WebBrowser não é mais válida.The WebBrowser instance is no longer valid.

Não foi possível recuperar uma referência ao WebBrowser nativo subjacente.A reference to the underlying native WebBrowser could not be retrieved.

Navegação de um aplicativo que está sendo executado em confiança parcial:Navigation from an application that is running in partial trust: - Para um Uri que não está localizado no site de origem ou- To a Uri that is not located at the site of origin, or O nome de

  • targetFrameName não é null ou vazio.
  • targetFrameName name is not null or empty.
  • Exemplos

    O exemplo a seguir mostra como navegar para um documento e abri-lo em uma nova janela do navegador especificando o destino "sobre: em branco".The following example shows how to navigate to a document and open it in a new browser window by specifying the "about:blank" target.

    <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 método Navigate(String, String, Byte[], String) para navegar até uma URL que pode incluir caracteres de escape.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Use o método Navigate(Uri, String, Byte[], String) para navegar até uma Uri que não inclua caracteres de escape.Use the Navigate(Uri, String, Byte[], String) method to navigate to a Uri that does not include escape characters.

    Navigate(String)

    Navega de forma assíncrona para o documento na URL especificada.Navigates asynchronously to the document at the specified URL.

    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.The URL to navigate to.

    Comentários

    Use o método Navigate(String) para navegar até uma URL que pode incluir caracteres de escape.Use the Navigate(String) method to navigate to a URL that may include escape characters. Use o método Navigate(Uri) para navegar até uma Uri que não inclua caracteres de escape.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    Navigate(Uri)

    Navega de forma assíncrona para o documento na Uri especificada.Navigate asynchronously to the document at the specified 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

    A Uri até a qual navegar.The Uri to navigate to.

    Exceções

    A instância WebBrowser não é mais válida.The WebBrowser instance is no longer valid.

    Não foi possível recuperar uma referência ao WebBrowser nativo subjacente.A reference to the underlying native WebBrowser could not be retrieved.

    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.Navigation from an application that is running in partial trust to a Uri that is not located at the site of origin.

    Exemplos

    O exemplo a seguir mostra como usar WebBrowser para navegar para um documento usando o método Navigate(Uri).The following example shows how to use WebBrowser to navigate to a document by using the Navigate(Uri) method.

    <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

    Chamar Navigate(Uri) tem o mesmo efeito que definir a propriedade Source.Calling Navigate(Uri) has the same effect as setting the Source property. Source é usado de marcação por desenvolvedores que desejam especificar declarativamente o documento inicial que WebBrowser navega quando WebBrowser é inicializado.Source is used from markup by developers who want to declaratively specify the initial document that WebBrowser navigates to when WebBrowser is initialized.

    Use o método Navigate(String) para navegar até uma URL que pode incluir caracteres de escape.Use the Navigate(String) method to navigate to a URL that may include escape characters. Use o método Navigate(Uri) para navegar até uma Uri que não inclua caracteres de escape.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    Aplica-se a