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 apportate ai valori delle sottoproprietà non influiscono sul rendering se modificato; in caso contrario, false. Il valore predefinito è false.
Eccezioni
I metadati sono già stati applicati a un'operazione di proprietà di dipendenza, in modo che i metadati siano sealed e le proprietà dei metadati non possano essere impostate.
Commenti
Questa opzione di metadati è pertinente per le proprietà di dipendenza che sono tipi di riferimento, in cui tale tipo ha valori di proprietà propri. In genere, la logica del sistema di layout prevede che qualsiasi proprietà di dipendenza con proprietà secondarie 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 macchine virtuali Windows.
Le proprietà sulle classi derivate di PropertyMetadata vengono in genere definite nel modello a oggetti come lettura/scrittura. In questo modo possono essere regolati dopo l'inizializzazione dell'istanza. Tuttavia, una volta che i metadati vengono utilizzati come parte di una chiamata a Register, AddOwnero OverrideMetadata, il sistema di proprietà abiliterà 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.
