DependencyProperty クラス

定義

スタイル設定、データ バインディング、アニメーション、継承などのメソッドを使用して設定できるプロパティを表します。

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) で次の機能がサポートされています。

  • プロパティはスタイルで設定できます。 詳細については、「のスタイル設定とテンプレートの」を参照してください。

  • このプロパティは、データ バインディングを使用して設定できます。 データ バインディングの依存関係プロパティの詳細については、「方法: 2 つのコントロールのプロパティをバインドする」を参照してください。

  • このプロパティは、動的リソース参照を使用して設定できます。 詳細については、「XAML リソース」を参照してください。

  • このプロパティは、要素ツリー内の親要素から自動的にその値を継承できます。 詳細については、「プロパティ値の継承参照してください。

  • プロパティはアニメーション化できます。 詳細については、「アニメーションの概要を する」を参照してください。

  • プロパティは、プロパティの以前の値が変更され、プロパティ値を強制的に設定できる場合に報告できます。 詳細については、「依存関係プロパティのコールバックと検証の」を参照してください。

  • プロパティは WPF に情報を報告します。たとえば、プロパティ値を変更するには、レイアウト システムが要素のビジュアルを再計算する必要があるかどうかなどです。

  • このプロパティは、VISUAL Studio 用 WPF デザイナーでサポートを受けます。 たとえば、プロパティ ウィンドウでプロパティを編集できます。

依存関係プロパティの詳細については、「依存関係プロパティの概要」を参照してください。 カスタム型のプロパティで上記の一覧の機能をサポートする場合は、依存関係プロパティを作成する必要があります。 カスタム依存関係プロパティを作成する方法については、「カスタム依存関係プロパティのを する」を参照してください。

添付プロパティは、任意のオブジェクトが添付プロパティを定義する型に情報を報告できるようにするプロパティです。 WPF では、DependencyObject から継承するすべての型は、プロパティを定義する型から型が継承されるかどうかに関係なく、添付プロパティを使用できます。 添付プロパティは、XAML 言語の機能です。 XAML で添付プロパティを設定するには、ownerTypeを使用します。propertyName 構文をします。 添付プロパティの例として、DockPanel.Dock プロパティがあります。 すべての DependencyObject 型で使用できるプロパティを作成する場合は、添付プロパティを作成する必要があります。 添付プロパティの作成方法など、添付プロパティの詳細については、「添付プロパティの概要 」を参照してください。

XAML 属性の使用法

<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

プロパティが存在するが、プロパティ システムによって設定された値がないことを示すために null ではなく、WPF プロパティ システムによって使用される静的な値を指定します。

プロパティ

DefaultMetadata

依存関係プロパティの既定のメタデータを取得します。

GlobalIndex

依存関係プロパティを一意に識別する内部で生成された値を取得します。

Name

依存関係プロパティの名前を取得します。

OwnerType

依存関係プロパティをプロパティ システムに登録したオブジェクトの型を取得するか、プロパティの所有者として追加します。

PropertyType

依存関係プロパティがその値に使用する型を取得します。

ReadOnly

この DependencyProperty インスタンスによって識別される依存関係プロパティが読み取り専用の依存関係プロパティであるかどうかを示す値を取得します。

ValidateValueCallback

依存関係プロパティの値検証コールバックを取得します。

メソッド

AddOwner(Type)

既に登録されている依存関係プロパティの所有者として別の型を追加します。

AddOwner(Type, PropertyMetadata)

既に登録されている依存関係プロパティの所有者として別の型を追加し、指定された所有者型に依存関係プロパティが存在するため、依存関係プロパティのメタデータを提供します。

Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

この DependencyPropertyのハッシュ コードを返します。

GetMetadata(DependencyObject)

指定したオブジェクト インスタンスに存在するこの依存関係プロパティのメタデータを返します。

GetMetadata(DependencyObjectType)

指定した型に存在するこの依存関係プロパティのメタデータを返します。

GetMetadata(Type)

指定した既存の型に存在するこの依存関係プロパティのメタデータを返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
IsValidType(Object)

元の依存関係プロパティの登録で指定されたプロパティ型に対してチェックされるように、指定した値がこの依存関係プロパティの型に対して許容できるかどうかを判断します。

IsValidValue(Object)

基本的な型チェックを使用して、指定された値がプロパティの型に対して受け入れられるかどうかを判断します。また、指定した値がその型の値の許容範囲内にある可能性もあります。

MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
OverrideMetadata(Type, PropertyMetadata)

指定した型のインスタンスに存在する場合に、この依存関係プロパティの代替メタデータを指定し、基本型から継承された依存関係プロパティに存在するメタデータをオーバーライドします。

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

指定した型のインスタンスに存在する場合に、読み取り専用の依存関係プロパティの代替メタデータを提供し、初期依存関係プロパティの登録で指定されたメタデータをオーバーライドします。 例外が発生しないようにするには、読み取り専用の依存関係プロパティの DependencyPropertyKey を渡す必要があります。

Register(String, Type, Type)

指定したプロパティ名、プロパティの種類、および所有者の型を使用して依存関係プロパティを登録します。

Register(String, Type, Type, PropertyMetadata)

指定したプロパティ名、プロパティの種類、所有者の種類、およびプロパティ メタデータを使用して依存関係プロパティを登録します。

Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)

指定したプロパティ名、プロパティの種類、所有者の型、プロパティ メタデータ、およびプロパティの値検証コールバックを使用して依存関係プロパティを登録します。

RegisterAttached(String, Type, Type)

指定したプロパティ名、プロパティの種類、および所有者の型を持つ添付プロパティを登録します。

RegisterAttached(String, Type, Type, PropertyMetadata)

添付プロパティを、指定したプロパティ名、プロパティの種類、所有者の型、およびプロパティ メタデータに登録します。

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

プロパティの指定したプロパティ型、所有者の型、プロパティ メタデータ、および値検証コールバックを使用して、添付プロパティを登録します。

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

指定したプロパティの種類、所有者の型、およびプロパティ メタデータを使用して、読み取り専用の添付プロパティを登録します。

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

指定したプロパティ型、所有者の型、プロパティ メタデータ、および検証コールバックを使用して、読み取り専用の添付プロパティを登録します。

RegisterReadOnly(String, Type, Type, PropertyMetadata)

指定したプロパティ型、所有者の型、およびプロパティ メタデータを使用して、読み取り専用の依存関係プロパティを登録します。

RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

指定したプロパティ型、所有者の型、プロパティ メタデータ、および検証コールバックを使用して、読み取り専用の依存関係プロパティを登録します。

ToString()

依存関係プロパティの文字列形式を返します。

適用対象

こちらもご覧ください