FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property SubPropertiesDoNotAffectRender As BooleanWartość właściwości
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
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.
