Mémoriser plusieurs ensembles d'états par instance de page
Mise à jour : novembre 2007
Cet exemple illustre la manière de mémoriser et de parcourir plusieurs séries d'état pour une instance de page unique.
Cet exemple présente une fonctionnalité spécifique de Windows Presentation Foundation et, par conséquent, ne suit pas les meilleures pratiques de développement d'applications. Pour un traitement complet des meilleures pratiques de développement d'applications Windows Presentation Foundation (WPF) et Microsoft .NET Framework, reportez-vous, selon les cas, aux documents suivants :
Accessibilité - Meilleures pratiques d'accessibilité
Localisation - Vue d'ensemble de la globalisation et de la localisation WPF
Performances - Optimisation des performances des applications WPF
Sécurité - Sécurité de Windows Presentation Foundation
Génération de l'exemple
Installez le Kit de développement logiciel (SDK) Windows et ouvrez la fenêtre Commande de son environnement de génération. Dans le menu Démarrer, pointez sur Tous les programmes et sur Microsoft Windows SDK, puis cliquez sur CMD Shell.
Téléchargez l'exemple, généralement à partir de la documentation du Kit de développement logiciel (SDK), vers votre disque dur local.
Pour générer l'exemple à partir de la fenêtre Commande de l'environnement de génération, accédez au répertoire source de l'exemple. À l'invite de commandes, tapez MSBUILD.
Pour générer l'exemple dans Microsoft Visual Studio, chargez l'exemple de solution ou de fichier projet, puis appuyez sur CTRL+MAJ+B.
Exécution de l'exemple
Pour exécuter l'exemple compilé à partir de la fenêtre Commande de l'environnement de génération, exécutez le fichier .exe du dossier Bin\Debug ou Bin\Release contenu sous le dossier du code source de l'exemple.
Pour exécuter l'exemple compilé avec le débogage dans Visual Studio, appuyez sur F5.
Notes
La navigation d'état permet de changer l'état d'un élément du contenu à enregistrer en tant qu'entrée d'historique de navigation, auquel vous pourrez encore accéder ultérieurement. Lors de la navigation, l'état enregistré par l'entrée d'historique de navigation est restauré.
Cet exemple présente la navigation d'état par enregistrement, en cas de modification de l'élément sélectionné dans une zone de liste. Chaque entrée d'état est stockée par un objet CustomContentState personnalisé, et est ajouté à l'historique de navigation par l'appel de AddBackEntry, pour ajouter l'entrée initiale et GetContentState pour conserver les entrées dans les différentes navigations. En outre, il présente le processus de suppression d'une entrée de navigation d'état depuis l'historique de navigation arrière.
Cette technique est particulièrement utile lorsque vous devez mémoriser et parcourir plusieurs séries d'état pour une instance de page unique. Pour mémoriser un élément d'état unique parmi plusieurs instances de page, il est conseillé d'utiliser une propriété de dépendance enregistrable sur journal (voir Mémoriser un seul élément d'état pour plusieurs instances d'une page). Pour mémoriser une série d'états pour plusieurs instances d'une page, il est conseillé d'utiliser IProvideCustomContentState (voir Mémoriser un seul ensemble d'états pour plusieurs instances d'une page).
.gif "Remarque importante") Remarque importante : |
|---|
Lorsque vous stockez des informations dans un état de contenu personnalisé, assurez-vous de ne pas stocker de références vers l'instance de la page dont vous mémorisez l'état lorsque vous quittez la page. Ceci évite que WPF libère l'instance de page et se détourne de l'objectif du comportement par défaut de l'historique de navigation. Si tel est votre souhait, vous pouvez envisager de plutôt utiliser KeepAlive. |
Voir aussi
Tâches
Mémoriser un seul ensemble d'états pour plusieurs instances d'une page