NavigationService.Navigate Método

Definición

Vaya de forma asincrónica al contenido de origen especificado.

Sobrecargas

Nombre Description
Navigate(Uri, Object, Boolean)

Navegue de forma asincrónica al contenido de origen ubicado en un URI, pase un objeto que contenga el estado de navegación para su procesamiento durante la navegación y espacio aislado del contenido.

Navigate(Uri, Object)

Navegue de forma asincrónica al contenido de origen ubicado en un URI y pase un objeto que contiene los datos que se usarán para su procesamiento durante la navegación.

Navigate(Uri)

Navegue de forma asincrónica al contenido especificado por un URI.

Navigate(Object)

Navegue de forma asincrónica al contenido contenido contenido por un objeto .

Navigate(Object, Object)

Navegue de forma asincrónica al contenido contenido contenido por un objeto y pase un objeto que contiene los datos que se usarán para su procesamiento durante la navegación.

Navigate(Uri, Object, Boolean)

Navegue de forma asincrónica al contenido de origen ubicado en un URI, pase un objeto que contenga el estado de navegación para su procesamiento durante la navegación y espacio aislado del contenido.

public:
 bool Navigate(Uri ^ source, System::Object ^ navigationState, bool sandboxExternalContent);
public bool Navigate(Uri source, object navigationState, bool sandboxExternalContent);
member this.Navigate : Uri * obj * bool -> bool
Public Function Navigate (source As Uri, navigationState As Object, sandboxExternalContent As Boolean) As Boolean

Parámetros

source
Uri

Objeto Uri inicializado con el URI para el contenido deseado.

navigationState
Object

Objeto que contiene los datos que se van a usar para su procesamiento durante la navegación.

sandboxExternalContent
Boolean

Descargue el contenido en un espacio aislado de seguridad de confianza parcial (con el conjunto de permisos predeterminado de la zona de Internet, si truees . El valor predeterminado es false.

Devoluciones

true si no se cancela una navegación; de lo contrario, false.

Comentarios

Este método solo es para aplicaciones independientes y contenido de Lenguaje de marcado extensible de aplicaciones (XAML).

Este método muestra el mismo comportamiento que NavigationService.Navigatey lo amplía asegurándose de que el contenido que se descarga se coloca en un espacio aislado de seguridad de confianza parcial (con el conjunto de permisos predeterminado de la zona de Internet; vea Seguridad de confianza parcial de WPF).

Consulte también

Se aplica a

Navigate(Uri, Object)

Navegue de forma asincrónica al contenido de origen ubicado en un URI y pase un objeto que contiene los datos que se usarán para su procesamiento durante la navegación.

public:
 bool Navigate(Uri ^ source, System::Object ^ navigationState);
public bool Navigate(Uri source, object navigationState);
member this.Navigate : Uri * obj -> bool
Public Function Navigate (source As Uri, navigationState As Object) As Boolean

Parámetros

source
Uri

Objeto Uri inicializado con el URI para el contenido deseado.

navigationState
Object

Objeto que contiene los datos que se van a usar para su procesamiento durante la navegación.

Devoluciones

true si no se cancela una navegación; de lo contrario, false.

Ejemplos

En el ejemplo siguiente se muestra cómo navegar a un URI y pasar el estado de navegación.

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
    DateTime requestDateTime = (DateTime)e.ExtraData;
    string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
    MessageBox.Show(msg);
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
    Dim requestDateTime As Date = CDate(e.ExtraData)
    Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
    MessageBox.Show(msg)
End Sub

Comentarios

Dado que las navegaciones son asincrónicas, es posible que varias navegaciones estén en curso al mismo tiempo. Por ejemplo, si hay dos fotogramas secundarios en una sola página, ambos fotogramas podrían estar navegando. En este caso, los distintos eventos de navegación generados por NavigationService se pueden generar varias veces, uno para cada fragmento de contenido al que se navega y no necesariamente para que se solicitaran las navegaciones. Por lo tanto, si una solicitud de navegación determinada necesita procesar datos específicos de la solicitud individual, no puede usar datos que estén disponibles para todas las solicitudes de navegación. En su lugar, puede usar navigationState para pasar datos para el procesamiento de navegación específico de una solicitud de navegación.

Los argumentos de evento siguientes proporcionan acceso al estado de navegación:

Consulte también

Se aplica a

Navigate(Uri)

Navegue de forma asincrónica al contenido especificado por un URI.

public:
 bool Navigate(Uri ^ source);
public bool Navigate(Uri source);
member this.Navigate : Uri -> bool
Public Function Navigate (source As Uri) As Boolean

Parámetros

source
Uri

Objeto Uri inicializado con el URI para el contenido deseado.

Devoluciones

true si no se cancela una navegación; de lo contrario, false.

Ejemplos

En el ejemplo siguiente se muestra cómo navegar a un URI.

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text));
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text))
End Sub

Comentarios

El valor de source puede ser una dirección URL web o un URI de paquete válido (consulte URI de paquete en WPF).

Navigate navegará al URI especificado por source si se cumplen las condiciones siguientes:

Si source es null, se borra el contenido existente (Content).

Nota:

Al descargar contenido web, puede recibir una excepción web (por ejemplo, 404: Archivo no encontrado). Puede controlar estas excepciones desde NavigationFailed.

Puede usar Navigate para navegar a un fragmento de contenido. Si el contenido identificado por el URI es el contenido actual, no se volverá a descargar.

Consulte también

Se aplica a

Navigate(Object)

Navegue de forma asincrónica al contenido contenido contenido por un objeto .

public:
 bool Navigate(System::Object ^ root);
public bool Navigate(object root);
member this.Navigate : obj -> bool
Public Function Navigate (root As Object) As Boolean

Parámetros

root
Object

Objeto que contiene el contenido al que navegar.

Devoluciones

true si no se cancela una navegación; de lo contrario, false.

Ejemplos

En el ejemplo siguiente se muestra cómo navegar a un Page objeto que contiene el árbol de contenido de origen.

void goObjectButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage());
}
Private Sub goObjectButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New ContentPage())
End Sub

Comentarios

Navigate navegará al Object especificado por root si se cumplen las condiciones siguientes:

Si root es null, se borra el contenido existente (Content).

Nota:

Al descargar contenido web, puede recibir una excepción web (por ejemplo, 404: Archivo no encontrado). Puede controlar estas excepciones desde NavigationFailed.

Consulte también

Se aplica a

Navigate(Object, Object)

Navegue de forma asincrónica al contenido contenido contenido por un objeto y pase un objeto que contiene los datos que se usarán para su procesamiento durante la navegación.

public:
 bool Navigate(System::Object ^ root, System::Object ^ navigationState);
public bool Navigate(object root, object navigationState);
member this.Navigate : obj * obj -> bool
Public Function Navigate (root As Object, navigationState As Object) As Boolean

Parámetros

root
Object

Objeto que contiene el contenido al que navegar.

navigationState
Object

Objeto que contiene los datos que se van a usar para su procesamiento durante la navegación.

Devoluciones

true si no se cancela una navegación; de lo contrario, false.

Ejemplos

En el ejemplo siguiente se muestra cómo navegar a un Page objeto que contiene el contenido de origen y pasar el estado de navegación.

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage(), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
    DateTime requestDateTime = (DateTime)e.ExtraData;
    string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
    MessageBox.Show(msg);
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New ContentPage(), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
    Dim requestDateTime As Date = CDate(e.ExtraData)
    Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
    MessageBox.Show(msg)
End Sub

Comentarios

Este método tiene el mismo comportamiento que NavigationService.Navigate, aunque se pasa un objeto en lugar de un URI.

Consulte también

Se aplica a