FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

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, set
Public Property SubPropertiesDoNotAffectRender As Boolean

Eigenschaftswert

Boolean

true, wenn sich Änderungen an untergeordneten Eigenschaftswerten nicht auf das Rendern auswirken, andernfalls false. Der Standardwert ist false.

Ausnahmen

InvalidOperationException

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.

Gilt für:

Weitere Informationen