FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of subeigenschappen van de afhankelijkheidseigenschap geen invloed hebben op de weergave van het betreffende object.
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 BooleanWaarde van eigenschap
true als wijzigingen in subeigenschapswaarden geen invloed hebben op rendering indien gewijzigd; anders, false. De standaardwaarde is false.
Uitzonderingen
De metagegevens zijn al toegepast op een afhankelijkheidseigenschapsbewerking, zodat metagegevens worden verzegeld en eigenschappen van de metagegevens niet kunnen worden ingesteld.
Opmerkingen
Deze optie voor metagegevens is relevant voor afhankelijkheidseigenschappen die verwijzingstypen zijn, waarbij dat type eigenschapswaarden van zichzelf heeft. Normaal gesproken is de logica van het indelingssysteem ervan uit te gaan dat een afhankelijkheidseigenschap met subeigenschappen mogelijk van invloed is op de indeling, omdat het controleren van alle subeigenschappen op wijzigingen tijdrovender is dan het uitvoeren van een andere renderpas. Het instellen van deze optie op true is handig voor het optimaliseren van de prestaties van de implementatie van het WPF indelingssysteem op frameworkniveau.
Eigenschappen van afgeleide klassen PropertyMetadata worden doorgaans gedefinieerd in het objectmodel als lezen/schrijven. Dit is zodat ze na de initialisatie van het exemplaar kunnen worden aangepast. Zodra de metagegevens echter worden gebruikt als onderdeel van een aanroep naar Register, AddOwnerof OverrideMetadata, zal het eigenschappensysteem dat metagegevensexemplaren en eigenschappen die de details van de metagegevens overbrengen, nu als onveranderbaar beschouwd worden. Als u deze eigenschap probeert in te stellen nadat IsSealedtrue deze zich op dit metagegevensexemplaren bevindt, wordt er een uitzondering gegenereerd.
XAML-tekstgebruik
Leden van deze klasse worden doorgaans niet gebruikt in XAML.
