PropertyMetadata 建構函式

  • 參考

定義

命名空間:
System.Windows
組件:
WindowsBase.dll

初始化 PropertyMetadata 類別的新執行個體。

多載

PropertyMetadata()

初始化 PropertyMetadata 類別的新執行個體。
PropertyMetadata(Object)

使用要套用這個中繼資料之相依性屬性的指定預設值，初始化 PropertyMetadata 類別的新執行個體。
PropertyMetadata(PropertyChangedCallback)

使用指定的 PropertyMetadata 實作參考，初始化 PropertyChangedCallback 類別的新執行個體。
PropertyMetadata(Object, PropertyChangedCallback)

使用指定的預設值和 PropertyMetadata 實作參考，初始化 PropertyChangedCallback 類別的新執行個體。
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

使用指定的預設值和回呼，初始化 PropertyMetadata 類別的新執行個體。

PropertyMetadata()

初始化 PropertyMetadata 類別的新執行個體。

public:
 PropertyMetadata();
public PropertyMetadata ();
Public Sub New ()

適用於

PropertyMetadata(Object)

使用要套用這個中繼資料之相依性屬性的指定預設值，初始化 PropertyMetadata 類別的新執行個體。

public:
 PropertyMetadata(System::Object ^ defaultValue);
public PropertyMetadata (object defaultValue);
new System.Windows.PropertyMetadata : obj -> System.Windows.PropertyMetadata
Public Sub New (defaultValue As Object)

參數

defaultValue
Object

指定相依性屬性的預設值，通常做為某些特定型別的值提供。

例外狀況

ArgumentException

defaultValue 無法設定為值 UnsetValue。

範例

static PropertyMetadata pm;

pm = new PropertyMetadata(Double.NaN);

備註

提供給 defaultValue 的值型別必須相符，或與要套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，可能會難以進行偵錯，因為編譯期間無法偵測不相符， (不相符將引發運行時例外狀況) 。

雖然它是每個無參數建構函式的預設值， defaultValue 但無法指定 的 UnsetValue 。 嘗試這樣做將會引發例外狀況。

適用於

PropertyMetadata(PropertyChangedCallback)

使用指定的 PropertyMetadata 實作參考，初始化 PropertyChangedCallback 類別的新執行個體。

public:
 PropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public PropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.PropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata
Public Sub New (propertyChangedCallback As PropertyChangedCallback)

參數

propertyChangedCallback
PropertyChangedCallback

處理常式實作的參考，當屬性的有效值變更時會由屬性系統呼叫。

範例

static PropertyMetadata pm;

pm = new PropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

適用於

PropertyMetadata(Object, PropertyChangedCallback)

使用指定的預設值和 PropertyMetadata 實作參考，初始化 PropertyChangedCallback 類別的新執行個體。

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata
Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

參數

defaultValue
Object

相依性屬性的預設值，通常是做為某些特定型別的值提供。

propertyChangedCallback
PropertyChangedCallback

處理常式實作的參考，當屬性的有效值變更時會由屬性系統呼叫。

例外狀況

ArgumentException

defaultValue 無法設定為值 UnsetValue。

範例

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

備註

提供 defaultValue 之值的型別必須相符或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，可能會難以進行偵錯，因為編譯期間無法偵測不相符， (不相符將引發運行時例外狀況) 。

雖然它是每個無參數建構函式的預設值， defaultValue 但無法指定 的 UnsetValue 。 嘗試這樣做將會引發例外狀況。

適用於

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

使用指定的預設值和回呼，初始化 PropertyMetadata 類別的新執行個體。

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);
public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);
new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.PropertyMetadata
Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

參數

defaultValue
Object

相依性屬性的預設值，通常是做為某些特定型別的值提供。

propertyChangedCallback
PropertyChangedCallback

處理常式實作的參考，當屬性的有效值變更時會由屬性系統呼叫。

coerceValueCallback
CoerceValueCallback

處理常式實作的參考，當屬性系統針對這個屬性呼叫 CoerceValue(DependencyProperty) 時便會呼叫。

例外狀況

ArgumentException

defaultValue 無法設定為值 UnsetValue。

範例

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

備註

如果您想要指定 ， CoerceValueCallback 但不是 PropertyChangedCallback ，您可以傳遞 null 參數 propertyChangedCallback 。

提供給 defaultValue 的值型別必須相符，或與要套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，可能會難以進行偵錯，因為編譯期間無法偵測不相符， (不相符將引發運行時例外狀況) 。

雖然它是每個無參數建構函式的預設值， defaultValue 但無法指定 的 UnsetValue 。 嘗試這樣做將會引發例外狀況。

適用於