AttributeProviderAttribute クラス

定義

public ref class AttributeProviderAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Property)]
public class AttributeProviderAttribute : Attribute

public class AttributeProviderAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Property)>]
type AttributeProviderAttribute = class
    inherit Attribute

type AttributeProviderAttribute = class
    inherit Attribute

Public Class AttributeProviderAttribute
Inherits Attribute

継承

Object

Attribute

AttributeProviderAttribute

属性

AttributeUsageAttribute

例

次のコード例では、AttributeProviderAttributeを使用して、特定の種類のIListSourceを持つDataSource プロパティをマークする方法を示します。 完全なコード一覧については、「 方法: Windows フォーム コントロールで属性を適用する」を参照してください。

[Category("Data")]
[Description("Indicates the source of data for the control.")]
[RefreshProperties(RefreshProperties.Repaint)]
[AttributeProvider(typeof(IListSource))]
public object DataSource
{
    get => _dataGridView1.DataSource;
    set => _dataGridView1.DataSource = value;
}

<Category("Data"), _
Description("Indicates the source of data for the control."), _
RefreshProperties(RefreshProperties.Repaint), _
AttributeProvider(GetType(IListSource))> _
Public Property DataSource() As Object
    Get
        Return Me.dataGridView1.DataSource
    End Get

    Set(ByVal value As Object)
        Me.dataGridView1.DataSource = value
    End Set
End Property

注釈

.NET Framework オブジェクト モデルでは、プロパティが意図的にあいまいに型指定されるケースがいくつかあります。 たとえば、 DataGridView.DataSource プロパティは objectとして型指定されます。 この理由は、このプロパティが複数の種類の入力を受け入れることができるためです。 残念ながら、プロパティの特性を記述するメタデータを追加する一般的な場所はありません。 .NET Framework 全体の各 DataSource プロパティには、型コンバーター、UI 型エディター、およびメタデータを必要とするその他のサービスに対して同じメタデータが必要です。 AttributeProviderAttributeは、この状況を解決します。

この属性をプロパティに配置すると、プロパティ記述子の MemberDescriptor.Attributes コレクションの属性を取得するための規則が異なります。 通常、プロパティ記述子はローカル属性を収集し、これらをプロパティ型の属性とマージします。 この場合、属性は、実際のプロパティ型ではなく、 AttributeProviderAttributeから返された型から取得されます。 この属性は、DataGridView.DataSource オブジェクトの特定の型をIListSourceにポイントするためにDataGridView.DataSourceで使用され、データ バインディングを有効にするために適切なメタデータがIListSourceに配置されます。 そうすることで、外部関係者はすべてのデータ ソースにメタデータを簡単に追加できます。

AttributeProviderAttributeで宣言された型から取得された属性には、プロパティの型の属性とプロパティの属性の間に優先順位があります。 次の一覧は、優先順位に従って、使用可能なマージされた属性の完全なセットを示しています。

• プロパティ属性

• 属性プロバイダーの属性

• プロパティ型の属性

こちらもご覧ください

• TypeDescriptor
• 型記述子の概要