語言

PropertyMetadata 建構函式

定義

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

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

多載

名稱 Description
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 值型必須與原始相依屬性註冊中指定的類型相符或相關，該屬性將被套用該元資料。 元資料預設值類型與所套用相依屬性類型不符的情況難以除錯，因為編譯過程中無法偵測到不符（不符會觸發執行時例外）。

雖然根據無參數建構器，這是預設的，但無法指定 a 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 值型必須與原始相依屬性註冊中指定的類型相符或相關聯，該屬性將被套用該元資料。 元資料預設值類型與所套用相依屬性類型不符的情況難以除錯，因為編譯過程中無法偵測到不符（不符會觸發執行時例外）。

雖然根據無參數建構器，這是預設的，但無法指定 a 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)
);

備註

如果你想指定 a CoerceValueCallback 但不指定 ，PropertyChangedCallback可以將參數 通過nullpropertyChangedCallback。

所提供的 defaultValue 值型必須與原始相依屬性註冊中指定的類型相符或相關，該屬性將被套用該元資料。 元資料預設值類型與所套用相依屬性類型不符的情況難以除錯，因為編譯過程中無法偵測到不符（不符會觸發執行時例外）。

雖然根據無參數建構器，這是預設的，但無法指定 a defaultValue 的 UnsetValue 。 嘗試如此行事將引發例外。

適用於