NavigationService.Navigate Méthode

Référence

Définition

Espace de noms:: System.Windows.Navigation

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Navigue de façon asynchrone jusqu'au contenu source spécifié.

Surcharges

Navigate(Uri, Object, Boolean)	Navigue de façon asynchrone jusqu’au contenu source situé à un URI, passe un objet contenant l’état de navigation pour le traitement lors de la navigation, puis applique le traitement du bac à sable (sandbox) au contenu.
Navigate(Uri, Object)	Navigue de façon asynchrone jusqu’au contenu source situé à un URI et passe un objet qui contient des données à utiliser pour le traitement lors de la navigation.
Navigate(Uri)	Navigue de façon asynchrone jusqu’au contenu spécifié par un URI.
Navigate(Object)	Navigue de façon asynchrone jusqu'au contenu inclus dans un objet.
Navigate(Object, Object)	Navigue de façon asynchrone jusqu'au contenu dans un objet et passe un objet contenant des données à utiliser pour le traitement lors de la navigation.

Navigue de façon asynchrone jusqu’au contenu source situé à un URI, passe un objet contenant l’état de navigation pour le traitement lors de la navigation, puis applique le traitement du bac à sable (sandbox) au contenu.

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

source: Uri

Objet Uri initialisé avec l’URI pour le contenu désiré.

navigationState: Object

Objet qui contient des données à utiliser pour le traitement lors de la navigation.

sandboxExternalContent: Boolean

Télécharge le contenu dans un bac à sable (sandbox) de sécurité de confiance partielle (avec le jeu d'autorisations de zones Internet par défaut, si la valeur est true. La valeur par défaut est false.

Retours

Boolean

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

S’applique à

Navigue de façon asynchrone jusqu’au contenu source situé à un URI et passe un objet qui contient des données à utiliser pour le traitement lors de la navigation.

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

source: Uri

Objet Uri initialisé avec l’URI pour le contenu désiré.

navigationState: Object

Objet qui contient des données à utiliser pour le traitement lors de la navigation.

Retours

Boolean

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

S’applique à

Navigue de façon asynchrone jusqu’au contenu spécifié par 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

Paramètres

source: Uri

Objet Uri initialisé avec l’URI pour le contenu désiré.

Retours

Boolean

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é.

Notes

Lorsque vous téléchargez du contenu Web, vous pouvez recevoir une exception Web (par exemple, 404 : Fichier introuvable). Vous pouvez gérer ces exceptions à partir de NavigationFailed.

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

S’applique à

Navigue de façon asynchrone jusqu'au contenu inclus dans un objet.

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

root: Object

Objet qui contient le contenu cible de la navigation.

Retours

Boolean

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é.

Notes

Lorsque vous téléchargez du contenu Web, vous pouvez recevoir une exception Web (par exemple, 404 : Fichier introuvable). Vous pouvez gérer ces exceptions à partir de NavigationFailed.

Voir aussi

S’applique à

Navigue de façon asynchrone jusqu'au contenu dans un objet et passe un objet contenant des données à utiliser pour le traitement lors de la navigation.

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

root: Object

Objet qui contient le contenu cible de la navigation.

navigationState: Object

Objet qui contient des données à utiliser pour le traitement lors de la navigation.

Retours

Boolean

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

S’applique à

Partager via

NavigationService.Navigate Méthode

Définition

Surcharges

Navigate(Uri, Object, Boolean)

Paramètres

Retours

Remarques

Voir aussi

S’applique à

Navigate(Uri, Object)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Navigate(Uri)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Navigate(Object)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Navigate(Object, Object)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires