IProvideCustomContentState Interface
Définition
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.
Implémenté par une classe qui doit ajouter un état personnalisé à l’entrée d’historique de navigation pour le contenu avant que le contenu ne soit éloigné de.
public interface class IProvideCustomContentStatepublic interface IProvideCustomContentStatetype IProvideCustomContentState = interfacePublic Interface IProvideCustomContentStateRemarques
IProvideCustomContentState vous permet d’associer une partie d’état personnalisé, implémentée en tant que classe personnalisée CustomContentState , à l’entrée d’historique de navigation pour le contenu qui a été éloigné du contenu.
L’état personnalisé peut également être associé de cette façon à l’aide des éléments suivants :
Appel de AddBackEntry :
Définition NavigatingCancelEventArgs.Content lorsque l’un des événements suivants est déclenché :
Vous devez implémenter IProvideCustomContentState lorsque vous ajoutez un état personnalisé à l’historique de navigation en appelant AddBackEntry, sinon l’historique de navigation ne fonctionnera pas correctement ; tenez compte des étapes suivantes :
AddBackEntry est appelé pour associer un état personnalisé au contenu actuel.
L’entrée de l’historique de navigation est renvoyée et la Replay méthode de l’état personnalisé est appelée, et l’état est appliqué au contenu.
Le contenu précédent est accédé dans l’historique de navigation vers l’avant.
L’entrée de l’historique de navigation est renvoyée, mais l’état personnalisé n’a pas été conservé depuis la dernière fois que l’entrée de l’historique de navigation à laquelle elle a été associée a été accédée.
Il s’agit du comportement par défaut, car l’état initialement enregistré dans un état personnalisé peut changer une fois qu’il a été ajouté à l’historique de navigation. Si l’objet d’état personnalisé est renvoyé à l’état et que son état est appliqué, avant que certains aspects concernant l’état changent avant que l’entrée dans l’historique de navigation ne soit redirigé, la modification de l’état ne peut pas être reflétée dans l’objet d’état personnalisé. En outre, AddBackEntry ne peut pas être appelé explicitement pour ajouter un nouvel objet d’état personnalisé qui reflète les modifications d’état. Par conséquent, pour garantir que l’état actuel d’une navigation particulière est toujours stocké dans l’historique de navigation, GetContentState il est appelé.
Essentiel
Lorsque vous stockez des informations dans un état de contenu personnalisé, vous ne pouvez pas stocker de références à l’instance de la page pour laquelle vous vous souvenez de l’état. Cela empêche WPF de libérer l’instance de page et de vaincre l’objectif du comportement d’historique de navigation par défaut. Si vous devez le faire, vous pouvez envisager d’utiliser KeepAlive à la place.
Méthodes
| Nom | Description |
|---|---|
| GetContentState() |
Retourne une instance d’une classe d’état personnalisée à associer au contenu dans l’historique de navigation. |