FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
PresentationFramework.dll

Pobiera lub ustawia wartość wskazującą, czy właściwości podrzędne właściwości zależności nie wpływają na renderowanie obiektu zawierającego.

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

Wartość właściwości

Boolean

true jeśli zmiany w wartościach właściwości podrzędnych nie mają wpływu na renderowanie w przypadku zmiany; w przeciwnym razie , false. Wartość domyślna to false.

Wyjątki

InvalidOperationException

Metadane zostały już zastosowane do operacji właściwości zależności, dzięki czemu metadane są zapieczętowane i nie można ustawić właściwości metadanych.

Uwagi

Ta opcja metadanych jest przeznaczona dla właściwości zależności, które są typami referencyjnymi, gdzie ten typ ma własne wartości właściwości. Zazwyczaj logika systemu układu polega na założeniu, że każda właściwość zależności z właściwościami podrzędnymi potencjalnie wpłynie na układ, ponieważ sprawdzanie wszystkich właściwości podrzędnych zmian jest bardziej czasochłonne niż rzeczywiste uruchomienie innego przebiegu renderowania. Ustawienie tej opcji true jest przydatne do optymalizacji wydajności implementacji systemu układu platformy WPF.

Właściwości klas pochodnych PropertyMetadata są zwykle definiowane w modelu obiektów jako odczyt-zapis. Dzięki temu można je dostosować po zainicjowaniu wystąpienia. Jednak po użyciu metadanych w ramach wywołania metody Register, AddOwnerlub OverrideMetadatasystem właściwości przypieczętuje, że wystąpienie metadanych i właściwości przekazujące szczegóły metadanych są teraz uznawane za niezmienne. Próba ustawienia tej właściwości po IsSealed wystąpieniu true metadanych spowoduje wystąpienie wyjątku.

Użycie tekstu w języku XAML

Składowe tej klasy nie są zwykle używane w języku XAML.

Dotyczy

Zobacz też