PropertyMetadata 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 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
指定相依性屬性的預設值,通常做為某些特定型別的值提供。
例外狀況
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
處理常式實作的參考,當屬性的有效值變更時會由屬性系統呼叫。
例外狀況
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) 時便會呼叫。
例外狀況
defaultValue
無法設定為值 UnsetValue。
範例
static PropertyMetadata pm;
pm = new PropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
備註
如果您想要指定 , CoerceValueCallback 但不是 PropertyChangedCallback ,您可以傳遞 null
參數 propertyChangedCallback
。
提供給 defaultValue
的值型別必須相符,或與要套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符,可能會難以進行偵錯,因為編譯期間無法偵測不相符, (不相符將引發運行時例外狀況) 。
雖然它是每個無參數建構函式的預設值, defaultValue
但無法指定 的 UnsetValue 。 嘗試這樣做將會引發例外狀況。