DependencyProperty.GetMetadata メソッド

定義

特定の型のメタデータが存在する場合、この依存関係プロパティに関連付けられているメタデータを返します。Returns the metadata associated with this dependency property as it exists for a particular type. 依存関係プロパティが最初に登録された型、その後で依存関係プロパティが追加された型、または継承を通じて依存関係プロパティが取得され、そのメタデータが明確にオーバーライドされた型を指定できます。This can be the type where the dependency property was first registered, one to which it was added subsequently, or a type where the dependency property was obtained through inheritance but the metadata was specifically overridden.

オーバーロード

GetMetadata(Type)

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

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.

public:
 System::Windows::PropertyMetadata ^ GetMetadata(Type ^ forType);
public System.Windows.PropertyMetadata GetMetadata (Type forType);
member this.GetMetadata : Type -> System.Windows.PropertyMetadata
Public Function GetMetadata (forType As Type) As PropertyMetadata

パラメーター

forType
Type

依存関係プロパティのメタデータを取得する対象の特定の型。The specific type from which to retrieve the dependency property metadata.

戻り値

プロパティ メタデータ オブジェクト。A property metadata object.

次の例では、型に基づいて依存関係プロパティのメタデータを取得します。The following example gets metadata for a dependency property based on its type. 型を取得するには、typeof 演算子を使用します。The type is obtained by using a typeof operator.

pm = MyStateControl.StateProperty.GetMetadata(typeof(MyStateControl));
pm = MyStateControl.StateProperty.GetMetadata(GetType(MyStateControl))

注釈

型として使用する型またはオブジェクト参照のいずれかを指定する必要があります。これは、型に存在する依存関係プロパティのメタデータを変更する AddOwner または OverrideMetadata 呼び出しが原因で、メタデータが元の登録と異なる可能性があるためです。Specifying either the type or an object reference to use as type is necessary because the metadata can vary from the original registration due either to AddOwner or OverrideMetadata calls that alter the metadata of the dependency property as it exists on a type.

GetMetadata(DependencyObject)

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

public:
 System::Windows::PropertyMetadata ^ GetMetadata(System::Windows::DependencyObject ^ dependencyObject);
public System.Windows.PropertyMetadata GetMetadata (System.Windows.DependencyObject dependencyObject);
member this.GetMetadata : System.Windows.DependencyObject -> System.Windows.PropertyMetadata

パラメーター

dependencyObject
DependencyObject

メタデータの取得元となる依存関係プロパティの型固有のバージョンを確認するために型をチェックするときの、対象となる依存関係オブジェクト。A dependency object that is checked for type, to determine which type-specific version of the dependency property the metadata should come from.

戻り値

プロパティ メタデータ オブジェクト。A property metadata object.

次の例では、特定の DependencyObject インスタンスに基づいて、依存関係プロパティのメタデータを取得します。The following example gets metadata for a dependency property based on a specific DependencyObject instance.

pm = MyAdvancedStateControl.StateProperty.GetMetadata(advancedInstance);
pm = MyAdvancedStateControl.StateProperty.GetMetadata(advancedInstance)

注釈

特定の依存関係プロパティのメタデータは、型に存在するときにプロパティメタデータを調整できる AddOwner または OverrideMetadata 呼び出しによって、元の登録と異なる可能性があるため、型またはオブジェクト参照のいずれかを指定する必要があります。Specifying either the type or an object reference is necessary because the metadata of any given dependency property can vary from the original registration due either to AddOwner or OverrideMetadata calls that can refine the property metadata as it exists on a type.

インスタンスに基づいてプロパティメタデータを要求する場合は、その型を内部で評価できるようにインスタンスを渡すだけです。When you request property metadata based on an instance, you are really just passing the instance so that its type can be evaluated internally. 依存関係プロパティのメタデータは、インスタンスごとに異なります。任意の型プロパティの組み合わせに対して常に一貫しています。Dependency property metadata does not vary per instance; it is always consistent for any given type-property combination.

GetMetadata(DependencyObjectType)

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

public:
 System::Windows::PropertyMetadata ^ GetMetadata(System::Windows::DependencyObjectType ^ dependencyObjectType);
public System.Windows.PropertyMetadata GetMetadata (System.Windows.DependencyObjectType dependencyObjectType);
member this.GetMetadata : System.Windows.DependencyObjectType -> System.Windows.PropertyMetadata

パラメーター

dependencyObjectType
DependencyObjectType

依存関係プロパティ メタデータの取得元となる依存関係オブジェクト型を記録する特定のオブジェクト。A specific object that records the dependency object type from which the dependency property metadata is desired.

戻り値

プロパティ メタデータ オブジェクト。A property metadata object.

次の例では、DependencyObjectTypeに基づいて依存関係プロパティのメタデータを取得します。The following example gets metadata for a dependency property based on its DependencyObjectType.

DependencyObjectType dt = unrelatedInstance.DependencyObjectType;
pm = UnrelatedStateControl.StateProperty.GetMetadata(dt);
Dim dt As DependencyObjectType = unrelatedInstance.DependencyObjectType
pm = UnrelatedStateControl.StateProperty.GetMetadata(dt)

注釈

特定の依存関係プロパティのメタデータは、型に存在するときにプロパティメタデータを調整できる AddOwner または OverrideMetadata 呼び出しによって、元の登録と異なる可能性があるため、型またはオブジェクト参照のいずれかを指定する必要があります。Specifying either the type or an object reference is necessary because the metadata of any given dependency property can vary from the original registration due either to AddOwner or OverrideMetadata calls that can refine the property metadata as it exists on a type.

適用対象