DependencyPropertyKey 類別

定義

命名空間:

System.Windows

組件:

WindowsBase.dll

提供對只讀相依性屬性的有限寫入存取的相依性屬性標識碼。

C#

public sealed class DependencyPropertyKey

繼承

Object

DependencyPropertyKey

範例

下列範例會註冊只讀相依性屬性，並針對其他類別成員的兩個用途使用索引鍵：實作 get “wrapper”，以及做為受保護判斷作業的標識符，該作業會根據其他屬性值的計算來設定值。

C#

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}

備註

DependencyPropertyKey 實例是使用 方法 RegisterReadOnly 或 RegisterAttachedReadOnly取得相依性屬性註冊呼叫的傳回值。

註冊相依性屬性的類型可以使用呼叫中的 DependencyPropertyKey，以 SetValue 和 ClearValue，將屬性的值調整為類別邏輯的一部分。 如果金鑰的存取層級允許，相關類別也可以使用金鑰和相依性屬性。 例如，您可以將索引鍵宣告為內部，而相同元件內的其他類型也可以設定該相依性屬性。

只讀相依性屬性註冊所傳回的 DependencyPropertyKey 不應公開，因為公開索引鍵會使屬性設定為可設定，因而使將它註冊為唯讀相依性屬性的點失敗。 此外，公開索引鍵會導致可用的相依性屬性行為與其 Common Language Runtime （CLR） 屬性包裝函式實作不符，這是錯誤的類別設計。

您應該改為將 DependencyPropertyKey 的 DependencyProperty 值公開為類別上的 public static readonlyDependencyProperty，而不是公開索引鍵本身。 這可讓 屬性傳回特定屬性系統作業的有效相依性屬性標識碼，例如列舉本機設定值。 不過，因此取得的標識碼對於許多屬性系統作業而言，DependencyProperty 沒有完整的功能。

屬性

DependencyProperty

取得與此特製化只讀相依性屬性標識符相關聯的相依性屬性標識符。

方法

OverrideMetadata(Type, PropertyMetadata)

覆寫這個相依性屬性標識碼所表示之只讀相依性屬性的元數據。

適用於

另請參閱

• DependencyProperty