DependencyProperty DependencyProperty DependencyProperty DependencyProperty Class

定義

スタイル設定、データ バインディング、アニメーション、および継承などの方法によって設定できるプロパティを表します。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
継承
DependencyPropertyDependencyPropertyDependencyPropertyDependencyProperty
属性

注釈

ADependencyPropertyで次の機能をサポートしている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 名前空間にない場合 (詳細については、次を参照してくださいXAML 名前空間および WPF XAML のマッピングの Namespace。)。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 UnsetValue UnsetValue 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 DefaultMetadata DefaultMetadata DefaultMetadata

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

GlobalIndex GlobalIndex GlobalIndex GlobalIndex

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

Name Name Name Name

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

OwnerType OwnerType OwnerType 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 PropertyType PropertyType PropertyType

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

ReadOnly ReadOnly ReadOnly ReadOnly

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

ValidateValueCallback ValidateValueCallback ValidateValueCallback ValidateValueCallback

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

メソッド

AddOwner(Type) AddOwner(Type) AddOwner(Type) AddOwner(Type)

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

AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) 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) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

GetMetadata(DependencyObject) GetMetadata(DependencyObject) GetMetadata(DependencyObject) GetMetadata(DependencyObject)

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

GetMetadata(DependencyObjectType) GetMetadata(DependencyObjectType) GetMetadata(DependencyObjectType) GetMetadata(DependencyObjectType)

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

GetMetadata(Type) GetMetadata(Type) GetMetadata(Type) GetMetadata(Type)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsValidType(Object) IsValidType(Object) IsValidType(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) IsValidValue(Object) IsValidValue(Object) 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) 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) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) 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) Register(String, Type, Type) Register(String, Type, Type) Register(String, Type, Type)

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

Register(String, Type, Type, PropertyMetadata) Register(String, Type, Type, PropertyMetadata) Register(String, Type, Type, PropertyMetadata) 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) Register(String, Type, Type, PropertyMetadata, ValidateValueCallback) Register(String, Type, Type, PropertyMetadata, ValidateValueCallback) 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) RegisterAttached(String, Type, Type) RegisterAttached(String, Type, Type) RegisterAttached(String, Type, Type)

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

RegisterAttached(String, Type, Type, PropertyMetadata) RegisterAttached(String, Type, Type, PropertyMetadata) RegisterAttached(String, Type, Type, PropertyMetadata) 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) RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback) RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback) 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) RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata) RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata) 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) RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback) RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback) 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) RegisterReadOnly(String, Type, Type, PropertyMetadata) RegisterReadOnly(String, Type, Type, PropertyMetadata) 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) RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback) RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback) 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() ToString() ToString() ToString()

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

適用対象

こちらもご覧ください