NavigationService.Navigate Método

Definición

Espacio de nombres:

System.Windows.Navigation

Ensamblado:

PresentationFramework.dll

Navegue asincrónicamente al contenido de origen especificado.

Sobrecargas

Navigate(Uri, Object, Boolean)	Navegue asincrónicamente al contenido de origen que se encuentra en el URI y pase un objeto que contenga el estado de navegación de procesamiento durante la navegación e incluya el contenido en el espacio aislado.
Navigate(Uri, Object)	Navegue asincrónicamente al contenido de origen que se encuentra en el URI y pase un objeto que contenga los datos que se van a usar para el procesamiento durante la navegación.
Navigate(Uri)	Navegue asincrónicamente a un contenido especificado por un URI.
Navigate(Object)	Navegue asincrónicamente al contenido incluido en un objeto.
Navigate(Object, Object)	Navegue asincrónicamente al contenido incluido en un objeto y pase un objeto con los datos que se van a usar para el procesamiento durante la navegación.

Navigate(Uri, Object, Boolean)

Navegue asincrónicamente al contenido de origen que se encuentra en el URI y pase un objeto que contenga el estado de navegación de procesamiento durante la navegación e incluya el contenido en el espacio aislado.

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 del contenido deseado.

navigationState

Object

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

sandboxExternalContent

Boolean

Descargue el contenido en un recinto de seguridad de confiable parcial (con el conjunto de zonas de Internet predeterminado de permisos, si es true. De manera predeterminada, es false.

Devoluciones

Boolean

Es true si no se cancela ninguna navegación; de lo contrario, es false.

Comentarios

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

Este método presenta el mismo comportamiento NavigationService.Navigateque y 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

• Navigate(Uri)
• Navigate(Uri, Object)
• Navigate(Object)
• Navigate(Object, Object)

Navigate(Uri, Object)

Navegue asincrónicamente al contenido de origen que se encuentra en el URI y pase un objeto que contenga los datos que se van a usar para el 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 del contenido deseado.

navigationState

Object

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

Devoluciones

Boolean

Es true si no se cancela ninguna navegación; de lo contrario, es 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 marcos 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:

• ExtraData (se pasa al Navigating evento).

• ExtraData (se pasa a los Navigatedcontroladores de eventos , NavigationStopped, LoadCompleted ).

Consulte también

• Navigate(Uri)
• Navigate(Uri, Object, Boolean)
• Navigate(Object)
• Navigate(Object, Object)

Navigate(Uri)

Navegue asincrónicamente a un 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 del contenido deseado.

Devoluciones

Boolean

Es true si no se cancela ninguna navegación; de lo contrario, es 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 Pack URI en WPF).

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

• El Navigating evento no se cancela.

• Se puede crear una solicitud web (consulte Navigating).

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 vuelve a descargar.

Consulte también

• Navigate(Uri, Object)
• Navigate(Uri, Object, Boolean)
• Navigate(Object)
• Navigate(Object, Object)

Navigate(Object)

Navegue asincrónicamente al contenido incluido en 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

Boolean

Es true si no se cancela ninguna navegación; de lo contrario, es 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:

• El Navigating evento no se cancela.

• Se puede crear una solicitud web (consulte Navigating).

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

• Navigate(Uri)
• Navigate(Uri, Object)
• Navigate(Uri, Object, Boolean)
• Navigate(Object, Object)

Navigate(Object, Object)

Navegue asincrónicamente al contenido incluido en un objeto y pase un objeto con los datos que se van a usar para el 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 el procesamiento durante la navegación.

Devoluciones

Boolean

Es true si no se cancela ninguna navegación; de lo contrario, es 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

• Navigate(Uri)
• Navigate(Uri, Object)
• Navigate(Uri, Object, Boolean)
• Navigate(Object)