PropertyMetadata 建構函式

定義

命名空間:

System.Windows

組件:

WindowsBase.dll

初始化 PropertyMetadata 類別的新實例。

多載

PropertyMetadata()	初始化 PropertyMetadata 類別的新實例。
PropertyMetadata(Object)	使用將套用此元數據之相依性屬性的指定預設值，初始化 PropertyMetadata 類別的新實例。
PropertyMetadata(PropertyChangedCallback)	使用指定的 PropertyChangedCallback 實作參考，初始化 PropertyMetadata 類別的新實例。
PropertyMetadata(Object, PropertyChangedCallback)	使用指定的預設值和 PropertyChangedCallback 實作參考，初始化 PropertyMetadata 類別的新實例。
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 提供之值的類型必須符合或與將套用此元數據之相依性屬性原始註冊中指定的類型相關。 元數據預設值類型與要套用的相依性屬性類型不符可能會難以偵錯，因為編譯期間無法偵測到不相符專案（不相符會導致運行時例外狀況）。

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

PropertyMetadata(PropertyChangedCallback)

使用指定的 PropertyChangedCallback 實作參考，初始化 PropertyMetadata 類別的新實例。

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)

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

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 必須符合或與將套用此元數據之相依性屬性原始註冊中指定的類型相關。 元數據預設值類型與要套用的相依性屬性類型不符可能會難以偵錯，因為編譯期間無法偵測到不相符專案（不相符會導致運行時例外狀況）。

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

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，您可以傳遞 propertyChangedCallback 參數的 null。

為 defaultValue 提供之值的類型必須符合或與將套用此元數據之相依性屬性原始註冊中指定的類型相關。 元數據預設值類型與要套用的相依性屬性類型不符可能會難以偵錯，因為編譯期間無法偵測到不相符專案（不相符會導致運行時例外狀況）。

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