Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
NavigationService, classe
Contient des méthodes, des propriétés et des événements pour prendre en charge la navigation.
Assembly : PresentationFramework (dans PresentationFramework.dll)
Le type NavigationService expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
CanGoBack | Obtient une valeur qui indique s'il existe au moins une entrée dans l'historique de navigation arrière. |
|
|
CanGoForward | Obtient une valeur qui indique s'il existe au moins une entrée dans l'historique de navigation avant. |
|
|
Content | Obtient ou affecte une référence à l'objet qui contient le contenu actuel. |
|
|
CurrentSource | Obtient l'uniform resource identifier (URI) du contenu cible de la dernière navigation. |
|
|
Source | Obtient ou définit l'uniform resource identifier (URI) du contenu actuel ou l'URI du contenu cible de la nouvelle navigation en cours. |
| Nom | Description | |
|---|---|---|
|
AddBackEntry | Ajoute une entrée à l'historique de navigation arrière qui contient un objet CustomContentState. |
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetNavigationService | Obtient une référence à NavigationService destinée au navigateur dont le contenu contient l'objet DependencyObject spécifié. |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
GoBack | Navigue jusqu'à l'entrée la plus récente dans l'historique de navigation arrière, s'il en existe une. |
|
|
GoForward | Navigue jusqu'à l'entrée la plus récente dans l'historique de navigation avant, s'il en existe une. |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
Navigate(Object) | Navigue de façon asynchrone jusqu'au contenu inclus dans un objet. |
|
|
Navigate(Uri) | Navigue de façon asynchrone jusqu'au contenu spécifié par un uniform resource identifier (URI). |
|
|
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. |
|
|
Navigate(Uri, Object) | Navigue de façon asynchrone jusqu'au contenu source situé à un uniform resource identifier (URI) et passe un objet qui contient des données à utiliser pour le traitement lors de la navigation. |
|
|
Navigate(Uri, Object, Boolean) | Navigue de façon asynchrone jusqu'au contenu source situé à un uniform resource identifier (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. |
|
|
Refresh | Recharge le contenu actuel. |
|
|
RemoveBackEntry | Supprime l'entrée de journal la plus récente de l'historique arrière. |
|
|
StopLoading | Met fin au téléchargement de contenu pour la requête de navigation en cours. |
|
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
| Nom | Description | |
|---|---|---|
|
FragmentNavigation | Se produit lorsque la navigation vers un fragment de contenu commence, ce qui peut être immédiatement si le fragment désiré est dans le contenu actuel, ou bien après que le contenu de la source XAML a été chargé, si le fragment désiré est dans un contenu différent. |
|
|
LoadCompleted | Se produit lorsque le contenu cible de la navigation a été chargé, analysé et que son rendu a commencé. |
|
|
Navigated | Se produit lorsque le contenu cible de la navigation a été trouvé et est disponible à partir de la propriété Content, bien qu'il puisse ne pas avoir été complètement chargé. |
|
|
Navigating | Se produit lorsqu'une nouvelle navigation est demandée. |
|
|
NavigationFailed | Se produit lorsqu'une erreur est levée en naviguant jusqu'au contenu demandé. |
|
|
NavigationProgress | Se produit périodiquement pendant un téléchargement pour fournir des informations sur la progression de la navigation. |
|
|
NavigationStopped | Se produit lorsque la méthode StopLoading est appelée ou lorsqu'une nouvelle navigation est demandée en même temps qu'une navigation déjà en cours. |
NavigationService encapsule la capacité de télécharger du contenu se limitant au contexte d'une navigation de style navigateur.
Le contenu peut être tout type d'objet .NET Framework et de fichiers HTML. Toutefois, les pages constituent en général le mode d'empaquetage de contenu préférable pour la navigation (consultez Page).
Le contenu peut être accessible par navigation en fournissant une instance d'un objet et en appelant une surcharge de la méthode Navigate qui accepte un objet :
Le contenu peut également être accessible par navigation en passant un uniform resource identifier (URI) relatif ou absolu à l'une des surcharges de méthode Navigate qui accepte un URI :
Lorsque le navigateur accède au contenu par URI, NavigationService retourne un objet qui contient le contenu.
La durée de vie d'une navigation peut être suivie au moyen des événements suivants :
Les événements ne sont pas tous déclenchés chaque fois qu'une navigation a lieu ; le jeu d'événements déclenchés est déterminé par le type de navigation qui se produit (contenu ou fragment de contenu) et par la manière dont se termine la navigation (annulation, arrêt ou échec).
L'illustration suivante montre la séquence dans laquelle ces événements se déclenchent :
Pendant ou après une navigation, NavigationService fournit des informations sur le contenu cible de la navigation, y compris l'URI du contenu cible de la navigation (Source), l'URI du contenu actuel (CurrentSource) et un objet qui contient le contenu cible de la navigation (Content).
Lorsque le navigateur atteint le contenu, NavigationService enregistre la navigation sous forme d'entrée dans l'historique de navigation. Une entrée est ajoutée à l'historique de navigation arrière soit lorsqu'une nouvelle navigation se produit, par l'appel à la méthode Navigate, soit en naviguant jusqu'à une entrée dans l'historique de navigation avant, par l'appel à GoForward. Une entrée est ajoutée à l'historique de navigation avant en naviguant jusqu'à une entrée dans l'historique de navigation arrière, en appelant GoBack. CanGoBack et CanGoForward signalent s'il y a des entrées dans l'historique de navigation arrière et avant, respectivement. En outre, l'entrée la plus récente dans l'historique de navigation arrière peut être supprimée en appelant RemoveBackEntry.
Par défaut, NavigationService ne stocke pas d'instance d'un objet de contenu dans l'historique de navigation. NavigationService crée à la place une instance de l'objet de contenu chaque fois qu'il est la cible d'une navigation, en utilisant l'historique de navigation. Ce comportement est conçu pour éviter une utilisation excessive de la mémoire lorsqu'un grand nombre de parties de contenu et des parties volumineuses sont cibles de navigations. Par conséquent, l'état du contenu n'est pas retenu d'une navigation à la suivante. Toutefois, WPF fournit plusieurs techniques selon lesquelles vous pouvez stocker un segment de l'état pour une partie du contenu dans l'historique de navigation.
Par l'utilisation de AddBackEntry, vous pouvez également retenir plusieurs ensembles d'états par instance de page.
NavigationService est une classe sealed et, par conséquent, ne peut pas être instanciée. NavigationService est alors utilisé par les navigateurs pour activer la navigation. Dans WPF, il existe deux navigateurs : NavigationWindow et Frame.
Sur le plan visuel, les XBAPs utilisent Internet Explorer 7 comme un navigateur, pour assurer une expérience utilisateur intégrée. Sur le plan physique toutefois, les XBAPs utilisent en fait NavigationWindow comme navigateur; la propriété MainWindow d'un XBAP qui exécute dans Internet Explorer 7 retourne une référence au NavigationWindow, et l'historique de navigation qui est géré par le NavigationWindow est intégré à l'historique de navigation géré par Internet Explorer 7 selon les points suivants :
-
Lorsque le navigateur accède au contenu en appelant Navigate, GoBack et GoForward à partir d'un XBAP, les entrées pertinentes d'historique de navigation sont également ajoutées à l'historique de navigation d'Internet Explorer 7.
-
Lorsque les entrées de l'UI de navigation d'Internet Explorer 7 sont sélectionnées, Internet Explorer 7 entraîne la navigation en arrière ou en avant de NavigationService jusqu'au contenu associé à ces entrées.
Remarque
|
|---|
|
Frame peut fournir son propre historique de navigation ou utiliser l'historique de navigation du navigateur qui l'héberge. Si Frame fournit son propre historique de navigation, il peut afficher sa propre UI de navigation pour parcourir les entrées de l'historique de navigation. Ces entrées ne sont pas ajoutées à l'historique du navigateur hôte (NavigationWindow, Frame, Internet Explorer) et, par conséquent, le navigateur ne peut pas y accéder à partir de l'UI de navigation de chacune d'entre elle (consultez JournalOwnership). |
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
