FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se le sottoproprietà della proprietà di dipendenza non influiscono sul rendering dell'oggetto contenitore.
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 BooleanValore della proprietà
true se le modifiche ai valori delle sottoproprietà non influiscono sul rendering. In caso contrario, false. Il valore predefinito è false.
Eccezioni
Poiché sono già stati applicati a un'operazione della proprietà di dipendenza, questi metadati sono sealed e non è possibile impostarne le proprietà.
Commenti
Questa opzione di metadati è pertinente per le proprietà di dipendenza che sono tipi riferimento, in cui tale tipo ha valori di proprietà propri. In genere, la logica del sistema di layout consiste nel presupporre che qualsiasi proprietà di dipendenza con sottoproprietà influisca potenzialmente sul layout, perché il controllo di tutte le sottoproprietà per le modifiche richiede più tempo rispetto all'esecuzione effettiva di un altro passaggio di rendering. L'impostazione di questa opzione su true è utile per ottimizzare le prestazioni dell'implementazione del sistema di layout a livello di framework WPF.
Le proprietà delle classi derivate di PropertyMetadata sono in genere definite nel modello a oggetti come lettura-scrittura. In questo modo possono essere regolati dopo l'inizializzazione dell'istanza. Tuttavia, dopo che i metadati vengono utilizzati come parte di una chiamata a Register, AddOwnero OverrideMetadata, il sistema di proprietà continuerà a bloccare l'istanza e le proprietà dei metadati che trasmettono le specifiche dei metadati sono ora considerate non modificabili. Se si tenta di impostare questa proprietà dopo IsSealed che si trova true in questa istanza di metadati, verrà generata un'eccezione.
Utilizzo del testo XAML
I membri di questa classe non vengono in genere usati in XAML.