DependencyProperty クラス

リファレンス

定義

名前空間:: System.Windows

アセンブリ:: WindowsBase.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: Object
DependencyProperty

属性: TypeConverterAttribute

注釈

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()	依存関係プロパティの文字列形式を返します。

適用対象

次の方法で共有