Propriétés de dépendance en lecture seule

Cette rubrique suppose que vous maîtrisez les scénarios de base de l'implémentation d'une propriété de dépendance et que vous savez comment les métadonnées sont appliquées à une propriété de dépendance personnalisée. Consultez Propriétés de dépendance personnalisées et Métadonnées de propriété de dépendance pour le contexte.

Certaines des propriétés de dépendance définies dans l'infrastructure Windows Presentation Foundation (WPF) sont en lecture seule. En règle générale, la définition de propriétés de dépendance en lecture seule s'impose dans la mesure où ces propriétés doivent être utilisées pour déterminer des états, mais lorsque l'état est influencé par divers facteurs, la simple affectation de l'état à la propriété n'est pas désirable d'un point de vue de la conception de l'interface utilisateur. Par exemple, la propriété IsMouseOver se limite à un état de surface déterminé par l'entrée à la souris. Toute tentative de définir par programme cette valeur en circonvenant la vraie entrée de la souris aurait des conséquences imprévisibles et provoquerait une incohérence.

Du fait que les propriétés de dépendance en lecture seule ne sont pas définissables, ces propriétés ne sont pas adaptées pour de nombreux scénarios pour lesquels elles fournissent normalement une solution (à savoir, liaison de données, directement stylable en valeur, validation, animation, héritage). Bien qu'elles ne soient pas définissables, les propriétés de dépendance offrent néanmoins des fonctions supplémentaires prises en charge par les propriétés de dépendance dans le système de propriétés. La fonction restante la plus importante est que la propriété de dépendance en lecture seule peut encore être utilisée comme déclencheur de propriété dans un style. Vous ne pouvez pas activer des déclencheurs avec une propriété Common Language Runtime (CLR) normale ; seule une propriété de dépendance le permet. La propriété IsMouseOver précitée constitue un exemple parfait de scénario dans lequel il peut être très utile de définir un style pour un contrôle, où une propriété visible, telle qu'un arrière-plan, un premier plan ou des propriétés similaires d'éléments composés dans le contrôle, change lorsque l'utilisateur place la souris sur une région définie du contrôle. Les modifications dans une propriété de dépendance en lecture seule peuvent être également détectées par les processus d'invalidation inhérents du système de propriétés, la fonctionnalité de déclenchement de propriété étant prise en charge en interne.

Veillez à lire la section ci-dessus qui explique pourquoi les propriétés de dépendance en lecture seule ne fonctionnent pas dans de nombreux scénarios de propriété de dépendance types. Mais si vous avez un scénario approprié, vous pouvez créer votre propre propriété de dépendance en lecture seule.

La majeure partie du processus de création d'une propriété de dépendance en lecture seule est identique à celles décrites dans les rubriques Propriétés de dépendance personnalisées et Comment : implémenter une propriété de dépendance. Il existe trois différences importantes :

• Lorsque vous inscrivez la propriété, appelez la méthode RegisterReadOnly au lieu de la méthode Register normale pour l'inscription de la propriété.

• Lors de l'implémentation de la propriété de "wrapper" CLR, veillez à ce que le wrapper n'ait pas aussi une implémentation définie pour qu'il n'existe pas d'incohérence dans l'état de lecture seule pour le wrapper public que vous exposez.

• L'objet retourné par l'inscription en lecture seule est DependencyPropertyKey et non pas DependencyProperty. Vous devez toujours stocker ce champ sous la forme d'un membre, mais en général vous ne le convertissez pas en membre public du type.

Quel que soit le champ ou la valeur privés que vous utilisez, le stockage de la propriété de dépendance en lecture seule peut être naturellement inscriptible en utilisant la logique de votre choix. Toutefois, la méthode la plus simple pour définir la propriété soit initialement, soit dans le cadre de la logique runtime consiste à utiliser les API du système de propriétés, plutôt qu'à circonvenir le système de propriétés et définir le champ de stockage privé directement. Il existe notamment une signature SetValue qui accepte un paramètre de type DependencyPropertyKey. La manière dont vous définissez par programme cette valeur et l'emplacement où vous la définissez dans votre logique d'application affectent la manière dont vous voulez définir l'accès dans la DependencyPropertyKey créée lorsque vous avez inscrit pour la première fois la propriété de dépendance. Si vous gérez cette logique dans la classe, vous pouvez indiquer qu'elle est privée ou, si elle doit être définie depuis d'autres parties de l'assembly, vous pouvez la définir en interne. Une approche consiste à appeler SetValue dans un gestionnaire d'événement de classe d'un événement pertinent qui signale à une instance de classe que la valeur de propriété stockée doit être changée. Une autre approche consiste à lier des propriétés de dépendance ensemble en utilisant des rappels PropertyChangedCallback et CoerceValueCallback appariés dans le cadre des métadonnées de ces propriétés pendant l'inscription.

Étant donné que DependencyPropertyKey est privé et qu'il n'est pas propagé par le système de propriétés en dehors du code, une propriété de dépendance en lecture seule offre une meilleure sécurité de paramétrage qu'une propriété de dépendance en lecture-écriture. Pour une propriété de dépendance en lecture-écriture, le champ d'identification est explicitement ou implicitement public et la propriété est donc largement définissable. Pour plus d'informations, consultez Sécurité de propriété de dépendance.

Concepts