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 sich untergeordnete Eigenschaften der Abhängigkeitseigenschaft nicht auf das Rendern des enthaltenden Objekts auswirken.
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
true, wenn sich Änderungen an untergeordneten Eigenschaftswerten nicht auf das Rendern auswirken, andernfalls false. Der Standardwert ist false.
Ausnahmen
Die Metadaten wurden bereits auf einen Vorgang der Abhängigkeitseigenschaft angewendet, sodass Metadaten versiegelt sind und keine Eigenschaften für Metadaten festgelegt werden können.
Hinweise
Diese Metadatenoption ist für Abhängigkeitseigenschaften relevant, die Verweistypen sind, wobei dieser Typ eigene Eigenschaftswerte aufweist. In der Regel wird bei der Layoutsystemlogik davon ausgegangen, dass sich jede Abhängigkeitseigenschaft mit untergeordneten Eigenschaften potenziell auf das Layout auswirkt, da das Überprüfen aller Untergeordneten Eigenschaften auf Änderungen zeitaufwendiger ist als die tatsächliche Ausführung eines anderen Renderdurchlaufs. Das Festlegen dieser Option auf true ist nützlich, um die Leistung der Layoutsystemimplementierung auf WPF-Frameworkebene zu optimieren.
Eigenschaften für abgeleitete Klassen von PropertyMetadata werden im Objektmodell in der Regel als Lese-/Schreibzugriff definiert. Dadurch können sie nach der Initialisierung der Instanz angepasst werden. Sobald die Metadaten jedoch als Teil eines Aufrufs Registervon , AddOwneroder OverrideMetadataverwendet werden, versiegelt das Eigenschaftensystem, dass Metadateninstanz und Eigenschaften, die die Besonderheiten der Metadaten vermitteln, jetzt als unveränderlich angesehen werden. Der Versuch, diese Eigenschaft festzulegen, nachdem IsSealed sich true auf dieser Metadateninstanz befindet, löst eine Ausnahme aus.
XAML-Textverwendung
Member dieser Klasse werden in der Regel nicht in XAML verwendet.
