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 に情報を報告します。

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

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

添付プロパティは、 オブジェクトが添付プロパティを定義する型に情報を報告できるプロパティです。 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.NameownerType の前に XML 名前空間プレフィックスを付けすることもできます。 この使用方法は、依存関係プロパティの所有者を解析コンテキストに指定する必要がある、遅れてバインドされたスタイルとテンプレートに特に TargetType 当てはっています。これは、 がまだ知られていないためです。 詳しくは、「 スタイルとテンプレート」をご覧ください。

attachedPropertyOwnerType . attachedPropertyName
添付プロパティの所有者、ドット (.)、および添付プロパティ名を指定する文字列。 attachedPropertyOwnerType の前に XML 名前空間プレフィックスを付けすることもできます。

フィールド

UnsetValue

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

プロパティ

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()

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

適用対象

こちらもご覧ください