FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出相依性屬性的子屬性是否不會影響包含物件的呈現。
public:
property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };
public bool SubPropertiesDoNotAffectRender { get; set; }
member this.SubPropertiesDoNotAffectRender : bool with get, set
Public Property SubPropertiesDoNotAffectRender As Boolean
屬性值
如果子屬性值變更不會影響呈現,則為 true
;否則為 false
。 預設為 false
。
例外狀況
中繼資料已套用至相依性屬性作業,因此中繼資料已密封,而且無法設定中繼資料的屬性。
備註
此中繼資料選項與參考類型的相依性屬性相關,其中該類型具有本身的屬性值。 一般而言,配置系統邏輯是假設任何具有子屬性的相依性屬性可能會影響配置,因為檢查所有子屬性是否有變更會比實際執行另一個轉譯階段更耗時。 將此選項設定為 true
有助於優化 WPF 架構層級配置系統實作的效能。
衍生類別 PropertyMetadata 上的屬性通常會在物件模型中定義為讀寫。 如此一來,就可以在實例初始化之後加以調整。 不過,一旦在呼叫 Register 、 AddOwner 或 OverrideMetadata 時取用中繼資料,屬性系統就會密封中繼資料實例和傳遞中繼資料特定屬性的中繼資料實例和屬性現在視為不可變。 嘗試在此中繼資料實例上設定此屬性之後 IsSealed true
,將會引發例外狀況。
XAML 文字使用方式
這個類別的成員通常不會在 XAML 中使用。