DependencyProperty 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表可以透過方法設定的屬性,例如樣式、資料繫結、動畫和繼承。
public ref class DependencyProperty sealed
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class
[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class
Public NotInheritable Class DependencyProperty
- 繼承
-
DependencyProperty
- 屬性
備註
DependencyProperty支援下列Windows Presentation Foundation (WPF) 功能:
屬性可以在樣式中設定。 如需詳細資訊,請參閱 樣式設定和範本化。
屬性可以透過資料系結來設定。 如需資料系結相依性屬性的詳細資訊,請參閱 如何:系結兩個控制項的屬性。
屬性可以使用動態資源參考來設定。 如需詳細資訊,請參閱 XAML 資源。
屬性可以從專案樹狀結構中的父元素自動繼承其值。 如需詳細資訊,請參閱屬性值繼承。
屬性可以產生動畫效果。 如需詳細資訊,請參閱 動畫概觀。
屬性可以報告屬性先前的值已變更,而且屬性值可以強制轉型。 如需詳細資訊,請參閱相依性屬性回呼和驗證。
屬性會將資訊報告給 WPF,例如變更屬性值是否應該要求配置系統重新編譯元素的視覺效果。
屬性會在 WPF Designer for Visual Studio 中收到支援。 例如,屬性可以在 [ 屬性 ] 視窗中編輯。
若要深入瞭解相依性屬性,請參閱 相依性屬性概觀。 如果您想要自訂類型的屬性支援上述清單中的功能,您應該建立相依性屬性。 若要瞭解如何建立自訂相依性屬性,請參閱 自訂相依性屬性。
附加屬性是屬性,可讓任何物件向定義附加屬性的類型報告資訊。 在 WPF 中,任何繼承自 DependencyObject 的類型都可以使用附加屬性,而不論類型是否繼承自訂屬性的類型。 附加屬性是 XAML 語言的功能。 若要在 XAML 中設定附加屬性,請使用 ownerType。propertyName 語法。 附加屬性的範例是 DockPanel.Dock 屬性。 如果您想要建立可用於所有 DependencyObject 類型的屬性,則應該建立附加屬性。 若要深入瞭解附加屬性,包括如何建立它們,請參閱 附加屬性概觀。
XAML Attribute Usage
<object property="dependencyPropertyName"/>
-或-
<object property="ownerType.dependencyPropertyName"/>
-或-
<object property="attachedPropertyOwnerType.attachedPropertyName"/>
XAML 值
dependencyPropertyName
指定所需相依性屬性之 的字串 DependencyProperty.Name 。 如果屬性不在預設 XML 命名空間 (中,則可以先加上 XML 命名空間前置詞,如需詳細資訊,請參閱 WPF XAML 的 XAML 命名空間和命名空間對應。)
ownerType
.dependencyPropertyName
字串,指定相依性屬性的擁有者類型、點 (.) ,然後指定 DependencyProperty.Name 。 ownerType
也可以前面加上 XML 命名空間前置詞。 此用法特別適用于晚期繫結樣式和範本,其中必須指定相依性屬性的擁有者來剖析內容,因為 TargetType
尚未知道 。 如需詳細資訊,請參閱 樣式設定和範本化。
attachedPropertyOwnerType
. attachedPropertyName
字串,指定附加屬性的擁有者、點 (.) ,然後指定附加屬性名稱。 attachedPropertyOwnerType
也可以前面加上 XML 命名空間前置詞。
欄位
UnsetValue |
指定 WPF 屬性系統所使用的靜態值,而不是 |
屬性
DefaultMetadata |
取得相依性屬性的預設中繼資料。 |
GlobalIndex |
取得可唯一識別相依性屬性的內部產生值。 |
Name |
取得相依性屬性的名稱。 |
OwnerType |
取得對屬性系統註冊相依性屬性之物件,或將本身作為屬性擁有者加入之物件的類型。 |
PropertyType |
取得相依性屬性用於其值的型別。 |
ReadOnly |
取得值,這個值表示此 DependencyProperty 執行個體所識別的相依性屬性是否為唯讀相依性屬性。 |
ValidateValueCallback |
取得相依性屬性的值驗證回呼。 |