WebBrowser.Navigate WebBrowser.Navigate WebBrowser.Navigate WebBrowser.Navigate Method

Definición

Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado.Navigate asynchronously to the document at the specified Uri.

Sobrecargas

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

Navega de forma asincrónica hasta el documento que se encuentra en la dirección indicada y especifica el marco de destino en el que se cargará el contenido del documento.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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

Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado y especifica el marco de destino en el que se cargará el contenido del documento.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

Navigate(String) Navigate(String) Navigate(String) Navigate(String)

Navega de forma asincrónica hasta el documento que se encuentra en la dirección URL especificada.Navigates asynchronously to the document at the specified URL.

Navigate(Uri) Navigate(Uri) Navigate(Uri) Navigate(Uri)

Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado.Navigate asynchronously to the document at the specified Uri.

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

Navega de forma asincrónica hasta el documento que se encuentra en la dirección indicada y especifica el marco de destino en el que se cargará el contenido del documento.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.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 String String String

Dirección URL hasta la que se navega.The URL to navigate to.

targetFrameName
String String String String

Nombre del marco en el que se muestra el contenido del documento.The name of the frame to display the document's content in.

postData
Byte[]

Datos HTTP POST que se van a enviar al servidor cuando se solicite el origen.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String String String String

Encabezados HTTP que se van a enviar al servidor cuando se solicite el origen.HTTP headers to send to the server when the source is requested.

Comentarios

Use el Navigate(String, String, Byte[], String) método para desplazarse a una dirección URL que puede incluir caracteres de escape.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Use la Navigate(Uri, String, Byte[], String) método para desplazarse a un Uri que no incluya 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) Navigate(Uri, String, Byte[], String) Navigate(Uri, String, Byte[], String) Navigate(Uri, String, Byte[], String)

Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado y especifica el marco de destino en el que se cargará el contenido del documento.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.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 Uri Uri Uri

Uri hasta el que se navega.The Uri to navigate to.

targetFrameName
String String String String

Nombre del marco en el que se muestra el contenido del documento.The name of the frame to display the document's content in.

postData
Byte[]

Datos HTTP POST que se van a enviar al servidor cuando se solicite el origen.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String String String String

Encabezados HTTP que se van a enviar al servidor cuando se solicite el origen.HTTP headers to send to the server when the source is requested.

Excepciones

No se ha podido recuperar una referencia al valor de WebBrowser nativo subyacente.A reference to the underlying native WebBrowser could not be retrieved.

Navegación desde una aplicación que se está ejecutando en confianza parcial:Navigation from an application that is running in partial trust: - Hasta un objeto Uri que no se encuentra en el sitio de origen o- To a Uri that is not located at the site of origin, or El nombre

  • targetFrameName no es null o está vacío.
  • targetFrameName name is not null or empty.
  • Ejemplos

    El ejemplo siguiente muestra cómo desplazarse a un documento y abrirlo en una nueva ventana del explorador mediante la especificación de la "acerca de: en blanco" destino.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);  
    }  
    

    Comentarios

    Use el Navigate(String, String, Byte[], String) método para desplazarse a una dirección URL que puede incluir caracteres de escape.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Use la Navigate(Uri, String, Byte[], String) método para desplazarse a un Uri que no incluya caracteres de escape.Use the Navigate(Uri, String, Byte[], String) method to navigate to a Uri that does not include escape characters.

    Navigate(String) Navigate(String) Navigate(String) Navigate(String)

    Navega de forma asincrónica hasta el documento que se encuentra en la dirección 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 String String String

    Dirección URL hasta la que se navega.The URL to navigate to.

    Comentarios

    Use el Navigate(String) método para desplazarse a una dirección URL que puede incluir caracteres de escape.Use the Navigate(String) method to navigate to a URL that may include escape characters. Use la Navigate(Uri) método para desplazarse a un Uri que no incluya caracteres de escape.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    Navigate(Uri) Navigate(Uri) Navigate(Uri) Navigate(Uri)

    Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado.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 Uri Uri Uri

    Uri hasta el que se navega.The Uri to navigate to.

    Excepciones

    No se ha podido recuperar una referencia al valor de WebBrowser nativo subyacente.A reference to the underlying native WebBrowser could not be retrieved.

    Se navega desde una aplicación que se está ejecutando en confianza parcial hasta un Uri que no se encuentra en el sitio de origen.Navigation from an application that is running in partial trust to a Uri that is not located at the site of origin.

    Ejemplos

    El ejemplo siguiente muestra cómo usar WebBrowser para navegar a un documento mediante el uso de la Navigate(Uri) método.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);  
    }  
    

    Comentarios

    Una llamada a Navigate(Uri) tiene el mismo efecto que establecer el Source propiedad.Calling Navigate(Uri) has the same effect as setting the Source property. Source los desarrolladores que desean especificar mediante declaración la inicial del documento que sirve de marcado WebBrowser navega al WebBrowser se ha 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 el Navigate(String) método para desplazarse a una dirección URL que puede incluir caracteres de escape.Use the Navigate(String) method to navigate to a URL that may include escape characters. Use la Navigate(Uri) método para desplazarse a un Uri que no incluya caracteres de escape.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    Se aplica a