NavigationService.Navigate Méthode

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

Paramètres

Retours

true si la navigation n'est pas annulée ; false, dans le cas contraire.

Remarques

Cette méthode est uniquement destinée aux applications autonomes et au contenu XAML (Extensible Application Markup Language).

Cette méthode présente le même comportement que NavigationService.Navigateet l’étend en s’assurant que le contenu téléchargé est placé dans un bac à sable de sécurité de confiance partielle (avec le jeu d’autorisations de zone Internet par défaut - voir Sécurité de confiance partielle WPF).

Voir aussi

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

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

Paramètres

Retours

true si la navigation n'est pas annulée ; false, dans le cas contraire.

Exemples

L’exemple suivant illustre la navigation vers un URI et le passage de l’état de navigation.

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

Remarques

Étant donné que les navigations sont asynchrones, il est possible que plusieurs navigations soient en cours en même temps. Par exemple, s’il existe deux cadres enfants sur une seule page, les deux cadres peuvent naviguer. Dans ce cas, les différents événements de navigation déclenchés par NavigationService peuvent être déclenchés plusieurs fois, une pour chaque élément de contenu auquel la navigation est effectuée, et pas nécessairement dans l’ordre où les navigations ont été demandées. Par conséquent, si une demande de navigation particulière doit traiter des données spécifiques à la demande individuelle, elle ne peut pas utiliser les données disponibles pour toutes les demandes de navigation. Au lieu de cela, vous pouvez utiliser navigationState pour transmettre des données pour le traitement de la navigation qui est spécifique à une demande de navigation.

Les arguments d’événement suivants permettent d’accéder à l’état de navigation :

• ExtraData (passé à l’événement Navigating ).

• ExtraData (passé aux Navigatedgestionnaires d’événements , NavigationStopped, LoadCompleted ).

Voir aussi

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

public:
 bool Navigate(Uri ^ source);

public bool Navigate (Uri source);

member this.Navigate : Uri -> bool

Public Function Navigate (source As Uri) As Boolean

Paramètres

Retours

true si la navigation n'est pas annulée ; false, dans le cas contraire.

Exemples

L’exemple suivant montre comment accéder à 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

Remarques

La valeur de source peut être une URL web ou un URI de pack valide (voir URI de pack dans WPF).

Navigate accède à l’URI spécifié par source si les conditions suivantes sont remplies :

• L’événement Navigating n’est pas annulé.

• Une requête web (voir Navigating) peut être créée.

Si source a la valeur null, le contenu existant (Content) est effacé.

Vous pouvez utiliser Navigate pour accéder à un fragment de contenu. Si le contenu identifié par l’URI est le contenu actuel, il n’est pas téléchargé à nouveau.

Voir aussi

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

public:
 bool Navigate(System::Object ^ root);

public bool Navigate (object root);

member this.Navigate : obj -> bool

Public Function Navigate (root As Object) As Boolean

Paramètres

Retours

true si la navigation n'est pas annulée ; false, dans le cas contraire.

Exemples

L’exemple suivant montre comment accéder à un Page objet contenant l’arborescence de contenu source.

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

Remarques

Navigate accède au Object spécifié par root si les conditions suivantes sont remplies :

• L’événement Navigating n’est pas annulé.

• Une requête web (voir Navigating) peut être créée.

Si root a la valeur null, le contenu existant (Content) est effacé.

Voir aussi

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

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

Paramètres

Retours

true si la navigation n'est pas annulée ; false, dans le cas contraire.

Exemples

L’exemple suivant montre comment accéder à un Page objet contenant le contenu source et passer l’état de navigation.

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

Remarques

Cette méthode a le même comportement que , bien qu’un NavigationService.Navigateobjet soit passé au lieu d’un URI.

Voir aussi

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