PropertyMetadata.Merge(PropertyMetadata, DependencyProperty) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將這些元資料與基礎元資料合併。
protected:
virtual void Merge(System::Windows::PropertyMetadata ^ baseMetadata, System::Windows::DependencyProperty ^ dp);
protected virtual void Merge(System.Windows.PropertyMetadata baseMetadata, System.Windows.DependencyProperty dp);
abstract member Merge : System.Windows.PropertyMetadata * System.Windows.DependencyProperty -> unit
override this.Merge : System.Windows.PropertyMetadata * System.Windows.DependencyProperty -> unit
Protected Overridable Sub Merge (baseMetadata As PropertyMetadata, dp As DependencyProperty)
參數
- baseMetadata
- PropertyMetadata
基礎元資料會與此實例的值合併。
這個元資料被套用到的相依屬性。
範例
以下範例實作了一種自訂元資料類型的合併,並在該屬性元資料中加入了額外的屬性。
public Boolean SupportsMyFeature
{
get { return _supportsMyFeature; }
set { if (!this.IsSealed) _supportsMyFeature = value; } //else may want to raise exception
}
protected override void Merge(PropertyMetadata baseMetadata, DependencyProperty dp)
{
base.Merge(baseMetadata, dp);
MyCustomPropertyMetadata mcpm = baseMetadata as MyCustomPropertyMetadata;
if (mcpm != null)
{
if (!this.SupportsMyFeature)
{//if not set, revert to base
this.SupportsMyFeature = mcpm.SupportsMyFeature;
}
}
}
備註
當元資料被覆寫時,此方法用於內部使用(OverrideMetadata 方法)。
給繼承者的注意事項
衍生於 的 PropertyMetadata 類別實作應覆寫此方法,以考慮其實作中新增的元資料屬性。 舉例來說,你的實作可能新增了一個新的旗標列舉值, Merge(PropertyMetadata, DependencyProperty) 實作應該能正確組合這些旗標。
一定要在執行實作程式碼前呼叫基礎實作,因為基礎實作會合併該型別上已定義 PropertyMetadata 的所有屬性。
合併的具體行為由你決定。 你可以選擇合併值、如果衍生的元資料保留在預設值,則回復為基值,或根據你為特定元資料類別加入的屬性類型及其意義,做許多其他行為。