FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger om underegenskaperna för beroendeegenskapen inte påverkar återgivningen av det innehållande objektet.
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 BooleanEgenskapsvärde
trueom ändringar i underegenskapsvärden inte påverkar återgivningen om de ändras. annars . false Standardvärdet är false.
Undantag
Metadata har redan tillämpats på en beroendeegenskapsåtgärd, så att metadata är förseglade och att egenskaperna för metadata inte kan anges.
Kommentarer
Det här metadataalternativet är relevant för beroendeegenskaper som är referenstyper, där den typen har egna egenskapsvärden. Normalt är layoutsystemlogik att anta att alla beroendeegenskaper med underegenskaper kan påverka layouten, eftersom det är mer tidskrävande att kontrollera alla underegenskaper för ändringar än att faktiskt köra ett annat återgivningspass. Att ange det här alternativet till true är användbart för att optimera prestanda för WPF implementering av layoutsystem på ramverksnivå.
Egenskaper för härledda klasser PropertyMetadata av definieras vanligtvis i objektmodellen som skrivskyddad. Detta gör att de kan justeras efter initieringen av instansen. Men när metadata används som en del av ett anrop till Register, AddOwnereller OverrideMetadata, kommer egenskapssystemet att försegla att metadatainstansen och egenskaperna som förmedlar informationen om metadata nu anses oföränderliga. Om du försöker ange den här egenskapen när IsSealed den finns true på den här metadatainstansen genereras ett undantag.
XAML-textanvändning
Medlemmar i den här klassen används vanligtvis inte i XAML.
