FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob untereigenschaften der Abhängigkeitseigenschaft das Rendern des enthaltenden Objekts nicht beeinflussen.
public:
property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };public bool SubPropertiesDoNotAffectRender { get; set; }member this.SubPropertiesDoNotAffectRender : bool with get, setPublic Property SubPropertiesDoNotAffectRender As BooleanEigenschaftswert
truewenn Änderungen an Untereigenschaftswerten sich nicht auf das Rendern auswirken, wenn sie geändert werden; andernfalls . false Der Standardwert lautet false.
Ausnahmen
Die Metadaten wurden bereits auf einen Abhängigkeitseigenschaftsvorgang angewendet, sodass Metadaten versiegelt sind und Eigenschaften der Metadaten nicht festgelegt werden können.
Hinweise
Diese Metadatenoption ist für Abhängigkeitseigenschaften relevant, die Referenztypen sind, wobei dieser Typ eigenschaftswerte besitzt. In der Regel besteht die Layoutsystemlogik darin, davon auszugehen, dass sich jede Abhängigkeitseigenschaft mit Untereigenschaften potenziell auf das Layout auswirkt, da das Überprüfen aller Untereigenschaften auf Änderungen viel zeitaufwändiger ist als das Ausführen eines anderen Renderdurchlaufs. Das Festlegen dieser Option auf true ist nützlich, um die Leistung der WPF Framework-Layoutsystemimplementierung zu optimieren.
Eigenschaften für abgeleitete Klassen PropertyMetadata werden in der Regel im Objektmodell als Lese-/Schreibzugriff definiert. Dies ist so, dass sie nach der Initialisierung der Instanz angepasst werden können. Sobald die Metadaten jedoch als Teil eines Aufrufs Registervon , AddOwneroder , oder OverrideMetadataverwendet werden, wird das Eigenschaftensystem die Metadateninstanz und -eigenschaften, die die Besonderheiten der Metadaten vermitteln, jetzt als unveränderlich betrachtet. Wenn Sie versuchen, diese Eigenschaft festzulegen, IsSealedtrue wird in dieser Metadateninstanz eine Ausnahme ausgelöst.
XAML-Textverwendung
Elemente dieser Klasse werden in der Regel nicht in XAML verwendet.
