DependencyProperty クラス

定義

スタイル設定、データ バインディング、アニメーション、および継承などの方法によって設定できるプロパティを表します。Represents a property that can be set through methods such as, styling, data binding, animation, and inheritance.

public ref class DependencyProperty sealed
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
type DependencyProperty = class
Public NotInheritable Class DependencyProperty
継承
DependencyProperty
属性

注釈

DependencyProperty は、Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)の次の機能をサポートしています。A DependencyProperty supports the following capabilities in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):

  • プロパティは、スタイルで設定できます。The property can be set in a style. 詳しくは、「 スタイルとテンプレート」をご覧ください。For more information, see Styling and Templating.

  • プロパティは、データバインディングを使用して設定できます。The property can be set through data binding. データバインディングの依存関係プロパティの詳細については、「方法:2 つのコントロールのプロパティをバインドします。For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • プロパティは、動的リソース参照を使用して設定できます。The property can be set with a dynamic resource reference. 詳細については、「XAML リソース」を参照してください。For more information, see XAML Resources.

  • プロパティは、要素ツリー内の親要素から自動的に値を継承できます。The property can inherit its value automatically from a parent element in the element tree. 詳細については、「プロパティ値の継承」を参照してください。For more information, see Property Value Inheritance.

  • プロパティはアニメーション化できます。The property can be animated. 詳しくは、「 アニメーションの概要」をご覧ください。For more information, see Animation Overview.

  • プロパティは、プロパティの前の値が変更されたときに報告でき、プロパティ値を強制的に変更できます。The property can report when the previous value of the property has been changed and the property value can be coerced. 詳しくは、「依存関係プロパティのコールバックと検証」を参照してください。For more information, see Dependency Property Callbacks and Validation.

  • プロパティは WPFWPFに情報を報告します。たとえば、プロパティ値を変更する場合は、レイアウトシステムが要素のビジュアルを再構成する必要があるかどうかなどです。The property reports information to WPFWPF, such as whether changing a property value should require the layout system to recompose the visuals for an element.

  • プロパティは、WPF Designer for Visual StudioWPF Designer for Visual Studioでサポートを受け取ります。The property receives support in the WPF Designer for Visual StudioWPF Designer for Visual Studio. たとえば、プロパティは [プロパティ] ウィンドウで編集できます。For example, the property can be edited in the Properties window.

依存関係プロパティの詳細については、「依存関係プロパティの概要」を参照してください。To learn more about dependency properties, see Dependency Properties Overview. カスタム型のプロパティで前の一覧の機能をサポートするには、依存関係プロパティを作成する必要があります。If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. カスタム依存関係プロパティを作成する方法については、「カスタム依存関係プロパティ」を参照してください。To learn how to create custom dependency properties, see Custom Dependency Properties.

添付プロパティは、任意のオブジェクトが添付プロパティを定義する型に情報を報告できるようにするプロパティです。An attached property is a property that enables any object to report information to the type that defines the attached property. WPFWPFでは、型がプロパティを定義する型から継承するかどうかに関係なく、DependencyObject から継承されるすべての型で、添付プロパティを使用できます。In WPFWPF, any type that inherits from DependencyObject can use an attached property regardless of whether the type inherits from the type that defines the property. 添付プロパティは、XAMLXAML 言語の機能です。An attached property is a feature of the XAMLXAML language. XAMLXAMLで添付プロパティを設定するには、 ownerTypeを使用します。propertyName構文。To set an attached property in XAMLXAML, use the ownerType.propertyName syntax. 添付プロパティの例としては、DockPanel.Dock プロパティがあります。An example of an attached property is the DockPanel.Dock property. すべての DependencyObject 型で使用できるプロパティを作成する場合は、添付プロパティを作成する必要があります。If you want to create a property that can be used on all DependencyObject types, then you should create an attached property. 添付プロパティの作成方法など、添付プロパティの詳細については、「添付プロパティの概要」を参照してください。To learn more about attached properties, including how to create them, see Attached Properties Overview.

XAML 属性の使用方法XAML Attribute Usage

<object property="dependencyPropertyName"/>  

- または --or-

<object property="ownerType.dependencyPropertyName"/>  

- または --or-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

XAML 値XAML Values

dependencyPropertyName
目的の依存関係プロパティの DependencyProperty.Name を指定する文字列。A string that specifies the DependencyProperty.Name of the desired dependency property. このプロパティが既定の XML 名前空間にない場合は、前に XML 名前空間プレフィックスを付けることができます (詳細については、「 WPF xaml の Xaml 名前空間と名前空間のマッピング」を参照してください)。This can be preceded by an XML namespace prefix if the property is not in the default XML namespace (for details, see XAML Namespaces and Namespace Mapping for WPF XAML.)

ownerType.dependencyPropertyNameownerType.dependencyPropertyName
依存関係プロパティの所有者の種類、ドット (.)、DependencyProperty.Nameを指定する文字列。A string that specifies an owner type of a dependency property, a dot (.), then the DependencyProperty.Name. ownerType の前に XML 名前空間プレフィックスを付けることもできます。ownerType can also be preceded by an XML namespace prefix. この使用法は、遅延バインディングされたスタイルとテンプレートに固有のものであり、TargetType がまだ知られていないため、コンテキストを解析するために依存関係プロパティの所有者を指定する必要があります。This usage is particular to late-bound styles and templates, where the owner of the dependency property must be specified for parsing context because the TargetType is not yet known. 詳しくは、「 スタイルとテンプレート」をご覧ください。For more information, see Styling and Templating.

attachedPropertyOwnerType のハッシュ コードを返します。attachedPropertyOwnerType . attachedPropertyName
添付プロパティの所有者、ドット (.)、添付プロパティ名を指定する文字列。A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType の前に XML 名前空間プレフィックスを付けることもできます。attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

フィールド

UnsetValue

プロパティは存在するが、その値がプロパティ システムによって設定されていないことを示すために、WPFWPF プロパティ システムが null の代わりに使用する静的な値を指定します。Specifies a static value that is used by the WPFWPF property system rather than null to indicate that the property exists, but does not have its value set by the property system.

プロパティ

DefaultMetadata

依存関係プロパティの既定のメタデータを取得します。Gets the default metadata of the dependency property.

GlobalIndex

依存関係プロパティを一意に識別する内部的に生成された値を取得します。Gets an internally generated value that uniquely identifies the dependency property.

Name

依存関係プロパティの名前を取得します。Gets the name of the dependency property.

OwnerType

依存関係プロパティをプロパティ システムに登録したオブジェクト、または自身をプロパティの所有者として追加したオブジェクトの型を取得します。Gets the type of the object that registered the dependency property with the property system, or added itself as owner of the property.

PropertyType

依存関係プロパティの値の型を取得します。Gets the type that the dependency property uses for its value.

ReadOnly

この DependencyProperty インスタンスによって識別される依存関係プロパティが読み取り専用の依存関係プロパティかどうかを示す値を取得します。Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

ValidateValueCallback

依存関係プロパティの値検証コールバックを取得します。Gets the value validation callback for the dependency property.

メソッド

AddOwner(Type)

登録済みの依存関係プロパティの所有者として、別の型を追加します。Adds another type as an owner of a dependency property that has already been registered.

AddOwner(Type, PropertyMetadata)

既に登録済みの依存関係プロパティの所有者として別の型を追加します。その際、提供される所有者の型に存在する依存関係プロパティに依存関係プロパティのメタデータを提供します。Adds another type as an owner of a dependency property that has already been registered, providing dependency property metadata for the dependency property as it will exist on the provided owner type.

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

この DependencyProperty のハッシュ コードを返します。Returns a hash code for this DependencyProperty.

GetMetadata(DependencyObject)

この依存関係プロパティのメタデータが指定したオブジェクト インスタンスに存在する場合に、このメタデータを返します。Returns the metadata for this dependency property as it exists on the specified object instance.

GetMetadata(DependencyObjectType)

指定した型に存在する場合の、この依存関係プロパティのメタデータを返します。Returns the metadata for this dependency property as it exists on a specified type.

GetMetadata(Type)

指定した既存の型に存在する場合の、この依存関係プロパティのメタデータを返します。Returns the metadata for this dependency property as it exists on a specified existing type.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
IsValidType(Object)

指定した値がこの依存関係プロパティの型で受け入れ可能かどうかを、依存関係プロパティの最初の登録で指定されたプロパティの型と照合することによって判断します。Determines whether a specified value is acceptable for this dependency property's type, as checked against the property type provided in the original dependency property registration.

IsValidValue(Object)

指定した値がプロパティの型で受け入れ可能かどうかを基本型チェックによって判断します。さらに、その型の有効値の範囲内にこの値があるかどうかを判断することもあります。Determines whether the provided value is accepted for the type of property through basic type checking, and also potentially if it is within the allowed range of values for that type.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

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

指定した型のインスタンスに存在する場合の代替メタデータをこの依存関係プロパティに提供し、基本型から継承されたときにこの依存関係プロパティに存在していたメタデータをオーバーライドします。Specifies alternate metadata for this dependency property when it is present on instances of a specified type, overriding the metadata that existed for the dependency property as it was inherited from base types.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

指定した型のインスタンスに存在する場合に代替メタデータを読み取り専用の依存関係プロパティに提供し、依存関係プロパティの最初の登録時に指定したメタデータをオーバーライドします。Supplies alternate metadata for a read-only dependency property when it is present on instances of a specified type, overriding the metadata that was provided in the initial dependency property registration. 例外の発生を防ぐために、読み取り専用の依存関係プロパティに DependencyPropertyKey を渡す必要があります。You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

Register(String, Type, Type)

プロパティ名、プロパティ型、所有者型を指定して、依存関係プロパティを登録します。Registers a dependency property with the specified property name, property type, and owner type.

Register(String, Type, Type, PropertyMetadata)

プロパティ名、プロパティの型、所有者の型、プロパティ メタデータを指定して、依存関係プロパティを登録します。Registers a dependency property with the specified property name, property type, owner type, and property metadata.

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

プロパティ名、プロパティ型、所有者型、プロパティ メタデータ、およびプロパティの値検証コールバックを指定して、依存関係プロパティを登録します。Registers a dependency property with the specified property name, property type, owner type, property metadata, and a value validation callback for the property.

RegisterAttached(String, Type, Type)

プロパティ名、プロパティ型、および所有者型を指定して、添付プロパティを登録します。Registers an attached property with the specified property name, property type, and owner type.

RegisterAttached(String, Type, Type, PropertyMetadata)

プロパティ名、プロパティの型、所有者の型、およびプロパティ メタデータを指定して、アタッチされるプロパティを登録します。Registers an attached property with the specified property name, property type, owner type, and property metadata.

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

プロパティ型、所有者型、プロパティ メタデータ、および値の検証コールバックを指定して、添付プロパティを登録します。Registers an attached property with the specified property type, owner type, property metadata, and value validation callback for the property.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

プロパティ型、所有者型、およびプロパティ メタデータを指定して、読み取り専用の添付プロパティを登録します。Registers a read-only attached property, with the specified property type, owner type, and property metadata.

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

プロパティ型、所有者型、プロパティ メタデータ、および検証コールバックを指定して、読み取り専用の添付プロパティを登録します。Registers a read-only attached property, with the specified property type, owner type, property metadata, and a validation callback.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

プロパティ型、所有者型、プロパティ メタデータを指定して、読み取り専用の依存関係プロパティを登録します。Registers a read-only dependency property, with the specified property type, owner type, and property metadata.

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

プロパティ型、所有者型、プロパティ メタデータ、および検証コールバックを指定して、読み取り専用の依存関係プロパティを登録します。Registers a read-only dependency property, with the specified property type, owner type, property metadata, and a validation callback.

ToString()

依存関係プロパティの文字列表現を返します。Returns the string representation of the dependency property.

適用対象

こちらもご覧ください