NavigationService NavigationService NavigationService NavigationService Class

Définition

Contient des méthodes, des propriétés et des événements pour prendre en charge la navigation.Contains methods, properties, and events to support navigation.

public ref class NavigationService sealed
public sealed class NavigationService
type NavigationService = class
Public NotInheritable Class NavigationService
Héritage
NavigationServiceNavigationServiceNavigationServiceNavigationService

Remarques

NavigationServiceencapsule la possibilité de télécharger du contenu dans le contexte d’une navigation de style navigateur.NavigationService encapsulates the ability to download content within the context of a browser-style navigation.

Le contenu peut être n’importe quel type de .NET Framework objet et de fichiers HTML.Content can be any type of .NET Framework object and HTML files. En règle générale, toutefois, les pages sont préférables pour empaqueter le contenu pour la Pagenavigation (consultez).In general, however, pages are the preferred as the way to package content for navigation (see Page).

Le contenu peut être parcouru en fournissant une instance d’un objet et en appelant une surcharge de la Navigate méthode qui accepte un objet :Content can be navigated to by providing an instance of an object and calling an overload of the Navigate method that accepts an object:

Vous pouvez également accéder au contenu en passant un URI relatif ou absolu à l’une des surcharges Navigate de méthode qui accepte un URI :Alternatively, content can be navigated to by passing a relative or absolute URI to one of the Navigate method overloads that accepts a URI:

Lorsque le contenu est accédé par l’URI, NavigationService retourne un objet qui contient le contenu.When content is navigated to by URI, NavigationService will return an object that contains the content.

La durée de vie d’une navigation peut être suivie à l’aide des événements suivants :The lifetime of a navigation can be tracked through the following events:

Tous les événements ne sont pas déclenchés chaque fois qu’une navigation se produit ; l’ensemble des é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 la navigation se termine (annulée, arrêtée ou en échec).Not all events are raised each time that a navigation occurs; the set of events that are raised is determined by the type of navigation that occurs (content or content fragment) and how the navigation completes (canceled, stopped, or failed).

L’illustration suivante montre l’ordre dans lequel ces événements sont déclenchés :The following figure illustrates the sequence in which these events are raised:

Organigramme de navigation entre les pagesPage navigation flow chart

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).During or after a navigation, NavigationService provides information about the content that is being navigated to, including the URI of the content being navigated to (Source), the URI of the current content (CurrentSource), and an object that contains the content that was navigated to (Content).

Lorsque le contenu est parcouru, NavigationService enregistre la navigation sous la forme d’une entrée dans l’historique de navigation.When content is navigated to, NavigationService records the navigation as an entry in navigation history. Une entrée est ajoutée à l’historique de navigation arrière lorsqu’une nouvelle navigation se produit, en Navigate appelant la méthode ou en accédant à une entrée dans l’historique de navigation avant GoForward, en appelant.An entry is added to back navigation history when either a new navigation occurs, by calling the Navigate method, or by navigating to an entry in forward navigation history, by calling GoForward. Une entrée est ajoutée à l’historique de navigation avant, en accédant à une entrée dans l’historique de GoBacknavigation arrière, en appelant.An entry is added to forward navigation history by navigating to an entry in back navigation history, by calling GoBack. CanGoBacket CanGoForward indiquent s’il y a des entrées dans l’historique de navigation arrière et avant, respectivement.CanGoBack and CanGoForward report whether there are entries in back and forward navigation history, respectively. En outre, l’entrée la plus récente dans l’historique de navigation arrière peut RemoveBackEntryêtre supprimée en appelant.Also, the most recent entry in back navigation history can be removed by calling RemoveBackEntry.

Par défaut, NavigationService ne stocke pas d’instance d’un objet de contenu dans l’historique de navigation.By default, NavigationService does not store an instance of a content object in navigation history. Au lieu NavigationService de cela, crée une nouvelle instance de l’objet de contenu chaque fois qu’il accède à à l’aide de l’historique de navigation.Instead, NavigationService creates a new instance of the content object each time it is navigated to by using navigation history. Ce comportement est conçu pour éviter une consommation excessive de mémoire lorsque des nombres importants et de gros éléments de contenu sont en cours de navigation.This behavior is designed to avoid excessive memory consumption when large numbers and large pieces of content are being navigated to. Par conséquent, l’état du contenu n’est pas mémorisé d’une navigation à la suivante.Consequently, the state of the content is not remembered from one navigation to the next. Toutefois, WPF fournit plusieurs techniques permettant de stocker un élément d’État pour une partie du contenu dans l’historique de navigation.However, WPF provides several techniques by which you can store a piece of state for a piece of content in navigation history.

À AddBackEntryl’aide de, vous pouvez également vous souvenir de plusieurs ensembles d’États pour une seule instance de page.Using AddBackEntry, you can also remember multiple sets of state for a single page instance.

NavigationServiceest une sealed classe et ne peut donc pas être instanciée ; NavigationService à la place, est utilisé par les navigateurs pour activer la navigation.NavigationService is a sealed class and therefore cannot be instantiated; instead, NavigationService is used by navigators to enable navigation. Dans WPF, il existe deux navigateurs : NavigationWindow et Frame.In WPF, there are two navigators: NavigationWindow and Frame.

Visuellement, XBAPXBAPs utilisez Internet Explorer 7Internet Explorer 7 comme navigateur pour offrir une expérience utilisateur intégrée.Visually, XBAPXBAPs use Internet Explorer 7Internet Explorer 7 as a navigator, to provide an integrated user experience. XBAPXBAPs Toutefois, en fait, il NavigationWindow est réellement utilisé comme navigateur MainWindow ; la propriété XBAPXBAP d’un Internet Explorer 7Internet Explorer 7 s’exécutant dans retourne une référence NavigationWindowau et l’historique de navigation est géré par le est intégré à l’historique de navigation qui est géré Internet Explorer 7Internet Explorer 7 par de l’une des manières suivantes : NavigationWindowPhysically, however, XBAPXBAPs actually use NavigationWindow as the navigator; the MainWindow property of an XBAPXBAP running in Internet Explorer 7Internet Explorer 7 will return a reference to the NavigationWindow, and the navigation history that is managed by the NavigationWindow is integrated with the navigation history that is managed by Internet Explorer 7Internet Explorer 7 in the following ways:

  • Lorsque le contenu est accédé en appelant Navigate, GoBacket GoForward à partir d’une XBAPXBAP entrée d’historique de navigation pertinente sont également ajoutées à Internet Explorer 7Internet Explorer 7 l’historique de navigation.When content is navigated to by calling Navigate, GoBack, and GoForward from within an XBAPXBAP the relevant navigation history entries are also added to Internet Explorer 7Internet Explorer 7 navigation history.

  • Lorsque les entrées de Internet Explorer 7Internet Explorer 7 la Interface utilisateurUI navigation sont sélectionnées Internet Explorer 7Internet Explorer 7 , NavigationService fait en sorte de naviguer vers l’arrière ou vers le contenu associé à ces entrées.When entries in the Internet Explorer 7Internet Explorer 7 navigation Interface utilisateurUI are selected, Internet Explorer 7Internet Explorer 7 causes NavigationService to navigate back or forwards to the content that is associated with those entries.

Notes

Un Frame peut fournir son propre historique de navigation ou utiliser l’historique de navigation du navigateur qui l’héberge.A Frame can provide its own navigation history, or use the navigation history of the navigator that hosts it. Si Frame fournit son propre historique de navigation, il peut afficher sa propre Interface utilisateurUI navigation pour parcourir les entrées dans l’historique de navigation ; ces entrées ne sont pas ajoutées à l’historique de navigation duNavigationWindownavigateur hôte (, Frame Interface utilisateurUI , Internet ExplorerInternet Explorer) et, par conséquent, ne peut pas accéder à à partir de la navigation de JournalOwnershipchaque (consultez).If Frame provides its own navigation history, it can display its own navigation Interface utilisateurUI to navigate through the entries in navigation history; those entries are not added to the navigation history of the host navigator (NavigationWindow, Frame, Internet ExplorerInternet Explorer) and, consequently, cannot be navigated to from the navigation Interface utilisateurUI of each (see JournalOwnership).

Propriétés

CanGoBack CanGoBack CanGoBack CanGoBack

Obtient une valeur qui indique s'il existe au moins une entrée dans l'historique de navigation arrière.Gets a value that indicates whether there is at least one entry in back navigation history.

CanGoForward CanGoForward CanGoForward CanGoForward

Obtient une valeur qui indique s'il existe au moins une entrée dans l'historique de navigation avant.Gets a value that indicates whether there is at least one entry in forward navigation history.

Content Content Content Content

Obtient ou affecte une référence à l'objet qui contient le contenu actuel.Gets or sets a reference to the object that contains the current content.

CurrentSource CurrentSource CurrentSource CurrentSource

Obtient l’URI du contenu cible de la dernière navigation.Gets the URI of the content that was last navigated to.

Source Source Source Source

Obtient ou définit l’URI du contenu actuel ou l’URI du contenu cible de la nouvelle navigation en cours.Gets or sets the URI of the current content, or the URI of new content that is currently being navigated to.

Méthodes

AddBackEntry(CustomContentState) AddBackEntry(CustomContentState) AddBackEntry(CustomContentState) AddBackEntry(CustomContentState)

Ajoute une entrée à l'historique de navigation arrière qui contient un objet CustomContentState.Adds an entry to back navigation history that contains a CustomContentState object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetNavigationService(DependencyObject) GetNavigationService(DependencyObject) GetNavigationService(DependencyObject) GetNavigationService(DependencyObject)

Obtient une référence à NavigationService destinée au navigateur dont le contenu contient l'objet DependencyObject spécifié.Gets a reference to the NavigationService for the navigator whose content contains the specified DependencyObject.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GoBack() GoBack() GoBack() GoBack()

Navigue jusqu'à l'entrée la plus récente dans l'historique de navigation arrière, s'il en existe une.Navigates to the most recent entry in back navigation history, if there is one.

GoForward() GoForward() GoForward() GoForward()

Navigue jusqu'à l'entrée la plus récente dans l'historique de navigation avant, s'il en existe une.Navigate to the most recent entry in forward navigation history, if there is one.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Navigate(Object) Navigate(Object) Navigate(Object) Navigate(Object)

Navigue de façon asynchrone jusqu'au contenu inclus dans un objet.Navigate asynchronously to content that is contained by an object.

Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object) 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 asynchronously to content that is contained by an object, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri) Navigate(Uri) Navigate(Uri) Navigate(Uri)

Navigue de façon asynchrone jusqu’au contenu spécifié par un URI.Navigate asynchronously to content that is specified by a URI.

Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object) 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 asynchronously to source content located at a URI, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) 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 asynchronously to source content located at a URI, pass an object containing navigation state for processing during navigation, and sandbox the content.

Refresh() Refresh() Refresh() Refresh()

Recharge le contenu actuel.Reloads the current content.

RemoveBackEntry() RemoveBackEntry() RemoveBackEntry() RemoveBackEntry()

Supprime l'entrée de journal la plus récente de l'historique arrière.Removes the most recent journal entry from back history.

StopLoading() StopLoading() StopLoading() StopLoading()

Met fin au téléchargement de contenu pour la requête de navigation en cours.Stops further downloading of content for the current navigation request.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Événements

FragmentNavigation FragmentNavigation FragmentNavigation 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 XAMLXAML a été chargé, si le fragment désiré est dans un contenu différent.Occurs when navigation to a content fragment begins, which occurs immediately, if the desired fragment is in the current content, or after the source XAMLXAML content has been loaded, if the desired fragment is in different content.

LoadCompleted LoadCompleted LoadCompleted LoadCompleted

Se produit lorsque le contenu cible de la navigation a été chargé, analysé et que son rendu a commencé.Occurs when content that was navigated to has been loaded, parsed, and has begun rendering.

Navigated Navigated Navigated Navigated

Se produit lorsque le contenu cible de la navigation a été trouvé et est disponible à partir de la propriété Content, même s'il n'a peut-être pas pu être complètement chargé.Occurs when the content that is being navigated to has been found, and is available from the Content property, although it may not have completed loading.

Navigating Navigating Navigating Navigating

Se produit quand une nouvelle navigation est demandée.Occurs when a new navigation is requested.

NavigationFailed NavigationFailed NavigationFailed NavigationFailed

Se produit lorsqu'une erreur est levée en naviguant jusqu'au contenu demandé.Occurs when an error occurs while navigating to the requested content.

NavigationProgress NavigationProgress NavigationProgress NavigationProgress

Se produit périodiquement au cours d'un téléchargement, pour donner des informations sur la progression de la navigation.Occurs periodically during a download to provide navigation progress information.

NavigationStopped NavigationStopped NavigationStopped NavigationStopped

Se produit lorsque la méthode StopLoading() est appelée ou lorsqu'une nouvelle navigation est demandée pendant qu'une navigation est déjà en cours.Occurs when the StopLoading() method is called, or when a new navigation is requested while a current navigation is in progress.

S’applique à