Compartir a través de

WebBrowser.Navigate Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Controls
Ensamblado:
PresentationFramework.dll

Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado.

Sobrecargas

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

Navega de forma asincrónica hasta el documento que se encuentra en la dirección URL indicada y especifica el marco de destino en el que se cargará el contenido del documento. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.
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. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.
Navigate(String)

Navega de forma asincrónica hasta el documento que se encuentra en la dirección URL especificada.
Navigate(Uri)

Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado.

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

Navega de forma asincrónica hasta el documento que se encuentra en la dirección URL indicada y especifica el marco de destino en el que se cargará el contenido del documento. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.

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

Dirección URL hasta la que se navega.

targetFrameName
String

Nombre del marco en el que se muestra el contenido del documento.

postData
Byte[]

Datos HTTP POST que se van a enviar al servidor cuando se solicite el origen.

additionalHeaders
String

Encabezados HTTP que se van a enviar al servidor cuando se solicite el origen.

Comentarios

Use el Navigate(String, String, Byte[], String) método para navegar a una dirección URL que puede incluir caracteres de escape. Use el Navigate(Uri, String, Byte[], String) método para navegar a un Uri objeto que no incluya caracteres de escape.

Se aplica a

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. Se pueden enviar datos HTTP POST y encabezados HTTP adicionales al servidor como parte de la solicitud de navegación.

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 hasta el que se navega.

targetFrameName
String

Nombre del marco en el que se muestra el contenido del documento.

postData
Byte[]

Datos HTTP POST que se van a enviar al servidor cuando se solicite el origen.

additionalHeaders
String

Encabezados HTTP que se van a enviar al servidor cuando se solicite el origen.

Excepciones

ObjectDisposedException

La instancia WebBrowser del extensor ya no es válida.

InvalidOperationException

No se ha podido recuperar una referencia al valor de WebBrowser nativo subyacente.

SecurityException

Navegación desde una aplicación que se está ejecutando en confianza parcial:

  • Hasta un objeto Uri que no se encuentra en el sitio de origen o El nombre
  • targetFrameName no es null o está vacío.

Ejemplos

En el ejemplo siguiente se muestra cómo navegar a un documento y abrirlo en una nueva ventana del explorador especificando el 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);  
}

Comentarios

Use el Navigate(String, String, Byte[], String) método para navegar a una dirección URL que puede incluir caracteres de escape. Use el Navigate(Uri, String, Byte[], String) método para navegar a un Uri objeto que no incluya caracteres de escape.

Se aplica a

Navigate(String)

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

Dirección URL hasta la que se navega.

Comentarios

Use el Navigate(String) método para navegar a una dirección URL que puede incluir caracteres de escape. Use el Navigate(Uri) método para navegar a un Uri objeto que no incluya caracteres de escape.

Se aplica a

Navigate(Uri)

Navega de forma asincrónica hasta el documento que se encuentra en el Uri especificado.

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 hasta el que se navega.

Excepciones

ObjectDisposedException

La instancia WebBrowser del extensor ya no es válida.

InvalidOperationException

No se ha podido recuperar una referencia al valor de WebBrowser nativo subyacente.

SecurityException

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.

Ejemplos

En el ejemplo siguiente se muestra cómo usar WebBrowser para navegar a un documento mediante el 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);  
}

Comentarios

La llamada a Navigate(Uri) tiene el mismo efecto que establecer la Source propiedad . Sourcelos desarrolladores que desean especificar mediante declaración el documento inicial que navega a cuando WebBrowser se inicializa lo usan los desarrolladores que WebBrowser desean especificar mediante declaración.

Use el Navigate(String) método para navegar a una dirección URL que puede incluir caracteres de escape. Use el Navigate(Uri) método para navegar a un Uri objeto que no incluya caracteres de escape.

Se aplica a