FrameworkPropertyMetadata 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 FrameworkPropertyMetadata 類別的新執行個體。
多載
FrameworkPropertyMetadata()
初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata();public FrameworkPropertyMetadata ();Public Sub New ()備註
這個簽章會將 的所有值 FrameworkPropertyMetadata 初始化為其屬性預設值。 DefaultValue 將會是 null ，而各種 FrameworkPropertyMetadata 布林屬性將會是 false 。
另請參閱
適用於
FrameworkPropertyMetadata(Object)
使用指定的預設值初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue);public FrameworkPropertyMetadata (object defaultValue);new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別的值。
例外狀況
defaultValue 設定為 UnsetValue。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
另請參閱
適用於
FrameworkPropertyMetadata(PropertyChangedCallback)
使用指定的 FrameworkPropertyMetadata 回呼初始化 PropertyChangedCallback 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadataPublic Sub New (propertyChangedCallback As PropertyChangedCallback)參數
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));
適用於
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)
使用提供的預設值和架構中繼資料選項，初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags);public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags);new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別的值。
中繼資料選項旗標 (FrameworkPropertyMetadataOptions 值的組合)。 這些選項會指定相依性屬性與系統互動的特性，例如版面配置或資料繫結。
例外狀況
defaultValue 設定為 UnsetValue。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault)
);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
標示為 參數中 flags 設定旗標的值，會將符合該 FrameworkPropertyMetadataOptions 旗標名稱的屬性布林值 FrameworkPropertyMetadata 設定為 true 。 只要中繼資料尚未套用至特定屬性系統作業，您就可以後續變更中繼資料中的屬性值。
另請參閱
適用於
FrameworkPropertyMetadata(Object, PropertyChangedCallback)
使用提供的預設值和指定的 FrameworkPropertyMetadata 回呼，初始化 PropertyChangedCallback 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別的值。
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
例外狀況
defaultValue 設定為 UnsetValue。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged)
);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
另請參閱
適用於
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)
使用指定的回呼初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadataPublic Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)參數
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
- coerceValueCallback
- CoerceValueCallback
當屬性系統針對這個相依性屬性呼叫 CoerceValue(DependencyProperty) 時，便會呼叫處理常式實作的參考。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
備註
這個實作會呼叫基底初始化運算式，然後在基底實例上設定 屬性來加入 coerceValueCallback 。
另請參閱
適用於
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)
使用提供的預設值和架構中繼資料選項，以及指定的 FrameworkPropertyMetadata 回呼，初始化 PropertyChangedCallback 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback);new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別的值。
中繼資料選項旗標 (FrameworkPropertyMetadataOptions 值的組合)。 這些選項會指定相依性屬性與系統互動的特性，例如版面配置或資料繫結。
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
例外狀況
defaultValue 設定為 UnsetValue。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged)
);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
標示為 參數中 flags 設定旗標的值，會將符合該 FrameworkPropertyMetadataOptions 旗標名稱的屬性布林值 FrameworkPropertyMetadata 設定為 true 。 只要中繼資料尚未套用至特定屬性系統作業，您仍然可以變更中繼資料中的屬性值。
另請參閱
適用於
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)
使用提供的預設值和指定的回呼，初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別。
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
- coerceValueCallback
- CoerceValueCallback
當屬性系統針對這個相依性屬性呼叫 CoerceValue(DependencyProperty) 時，便會呼叫之處理常式實作的參考。
例外狀況
defaultValue 設定為 UnsetValue。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
另請參閱
適用於
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)
使用提供的預設值和架構中繼資料選項，以及指定的回呼，初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別。
中繼資料選項旗標 (FrameworkPropertyMetadataOptions 值的組合)。 這些選項會指定相依性屬性與系統互動的特性，例如版面配置或資料繫結。
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
- coerceValueCallback
- CoerceValueCallback
當屬性系統針對這個屬性呼叫 CoerceValue(DependencyProperty) 時，便會呼叫之處理常式實作的參考。
例外狀況
defaultValue 設定為 UnsetValue。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
標示為 參數中 flags 設定旗標的值，會將符合該 FrameworkPropertyMetadataOptions 旗標名稱的屬性布林值 FrameworkPropertyMetadata 設定為 true 。 只要中繼資料尚未套用至特定屬性系統作業，您仍然可以變更中繼資料中的屬性值。
另請參閱
適用於
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)
使用提供的預設值和架構中繼資料選項、指定的回呼，以及可用以防止屬性動畫的布林值，初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited);public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited);new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別。
中繼資料選項旗標 (FrameworkPropertyMetadataOptions 值的組合)。 這些選項會指定相依性屬性與系統互動的特性，例如版面配置或資料繫結。
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
- coerceValueCallback
- CoerceValueCallback
當屬性系統針對這個相依性屬性呼叫 CoerceValue(DependencyProperty) 時，便會呼叫之處理常式實作的參考。
- isAnimationProhibited
- Boolean
true 表示防止屬性系統為套用這個中繼資料的屬性顯示動畫。 如果嘗試顯示這類屬性的動畫，則屬性系統會發出執行階段例外狀況。 false 表示允許建立屬性的動畫。 預設為 false。
例外狀況
defaultValue 設定為 UnsetValue。
範例
下列範例會呼叫此建構函式簽章：
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading),
true //Animation prohibited
);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
參數 isAnimationProhibited 會設定立即基 UIPropertyMetadata 類所宣告之 IsAnimationProhibited 屬性的初始值。
標示為 參數中 flags 設定旗標的值，會將符合該 FrameworkPropertyMetadataOptions 旗標名稱的屬性布林值 FrameworkPropertyMetadata 設定為 true 。 只要中繼資料尚未套用至特定屬性系統作業，您仍然可以變更中繼資料中的屬性值。
另請參閱
適用於
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)
使用提供的預設值和架構中繼資料選項、指定的回呼、可用以防止屬性動畫的布林值，以及資料繫結更新觸發程序的預設值，初始化 FrameworkPropertyMetadata 類別的新執行個體。
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited, System::Windows::Data::UpdateSourceTrigger defaultUpdateSourceTrigger);public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited, System.Windows.Data.UpdateSourceTrigger defaultUpdateSourceTrigger);new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool * System.Windows.Data.UpdateSourceTrigger -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean, defaultUpdateSourceTrigger As UpdateSourceTrigger)參數
- defaultValue
- Object
相依性屬性的預設值，通常為特定型別。
中繼資料選項旗標 (FrameworkPropertyMetadataOptions 值的組合)。 這些選項會指定相依性屬性與系統互動的特性，例如版面配置或資料繫結。
- propertyChangedCallback
- PropertyChangedCallback
當屬性的有效值變更時，便會呼叫屬性系統之處理常式實作的參考。
- coerceValueCallback
- CoerceValueCallback
當屬性系統針對這個屬性呼叫 CoerceValue(DependencyProperty) 時，便會呼叫之處理常式實作的參考。
- isAnimationProhibited
- Boolean
true 表示防止屬性系統為套用這個中繼資料的屬性顯示動畫。 如果嘗試顯示這類屬性的動畫，則屬性系統會發出執行階段例外狀況。 預設為 false。
- defaultUpdateSourceTrigger
- UpdateSourceTrigger
在套用這個屬性的繫結、且這些繫結的 UpdateSourceTrigger 是設為 UpdateSourceTrigger 時所使用的 Default。
例外狀況
defaultValue 設定為 UnsetValue。
範例
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading),
true //Animation prohibited
, UpdateSourceTrigger.PropertyChanged
);
備註
提供給 defaultValue 的數值型別必須符合或與套用此中繼資料之相依性屬性原始註冊中指定的類型相關。 中繼資料預設值類型和要套用的相依性屬性類型不符，很難進行偵錯，因為編譯期間無法偵測不相符。 屬性系統在執行時間之前不會評估屬性的有效值，因此預設值類型/屬性類型不相符的結果是執行階段錯誤。
這個值 UnsetValue 在屬性系統中具有特殊意義，而且不能當做相依性屬性預設值使用。
參數 isAnimationProhibited 會設定立即基 UIPropertyMetadata 類所宣告之 IsAnimationProhibited 屬性的初始值。
如需系結更新來源行為的詳細資訊，請參閱 資料系結概觀。
標示為 參數中 flags 設定旗標的值，會將符合該 FrameworkPropertyMetadataOptions 旗標名稱的屬性布林值 FrameworkPropertyMetadata 設定為 true 。 只要中繼資料尚未套用至特定屬性系統作業，您仍然可以變更中繼資料中的屬性值。
另請參閱
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應