FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit une valeur qui indique si les sous-propriétés de la propriété de dépendance n’affectent pas le rendu de l’objet conteneur.

public:
 property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };

public bool SubPropertiesDoNotAffectRender { get; set; }

member this.SubPropertiesDoNotAffectRender : bool with get, set

Public Property SubPropertiesDoNotAffectRender As Boolean

Valeur de propriété

Boolean

true si les valeurs de sous-propriété n’affectent pas le rendu si elles sont modifiées ; sinon, false. La valeur par défaut est false.

Exceptions

InvalidOperationException

Les métadonnées ont déjà été appliquées à une opération de propriété de dépendance : elles sont donc sealed et les propriétés des métadonnées ne peuvent pas être définies.

Remarques

Cette option de métadonnées est pertinente pour les propriétés de dépendance qui sont des types référence, où ce type a des valeurs de propriété propres. En règle générale, la logique système de disposition consiste à supposer que toute propriété de dépendance avec des sous-propriétés affecte potentiellement la disposition, car la vérification de toutes les sous-propriétés pour les modifications prend plus de temps que l’exécution d’une autre passe de rendu. La définition de true cette option est utile pour optimiser les performances de l’implémentation du système de disposition au niveau de l’infrastructure WPF.

Les propriétés sur les classes dérivées de PropertyMetadata sont généralement définies dans le modèle objet en lecture-écriture. C’est pourquoi ils peuvent être ajustés après l’initialisation de l’instance. Toutefois, une fois que les métadonnées sont consommées dans le cadre d’un appel à Register, AddOwnerou OverrideMetadata, le système de propriétés scellera cette instance de métadonnées et les propriétés qui transmettent les spécificités des métadonnées sont désormais considérées comme immuables. Toute tentative de définition de cette propriété après IsSealed avoir été true effectuée sur cette instance de métadonnées génère une exception.

Utilisation du texte XAML

Les membres de cette classe ne sont généralement pas utilisés en XAML.

Voir aussi

• Freezable