AttributeProviderAttribute Klasse

Definition

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

Vererbung

Object

Attribute

AttributeProviderAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der Markierung AttributeProviderAttribute einer DataSource Eigenschaft mit einem bestimmten Typ von IListSource. Eine vollständige Codeauflistung finden Sie unter How to: Apply Attributes in Windows Forms Controls.

[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

Hinweise

Es gibt einige Fälle im .NET Framework-Objektmodell, in denen eine Eigenschaft absichtlich als vage typiert wird. Die Eigenschaft wird z DataGridView.DataSource . B. als object. Der Grund dafür ist, dass diese Eigenschaft mehrere Eingabetypen akzeptieren kann. Leider bietet dies keinen gemeinsamen Ort, um Metadaten hinzuzufügen, um die Merkmale der Eigenschaft zu beschreiben. Jede DataSource Eigenschaft im .NET Framework muss identische Metadaten für Typkonverter, Benutzeroberflächentyp-Editoren und andere Dienste aufweisen, die Metadaten erfordern. Die Abhilfe AttributeProviderAttribute für diese Situation.

Sobald dieses Attribut für eine Eigenschaft platziert wird, unterscheiden sich die Regeln zum Abrufen von Attributen für die Auflistung des Eigenschaftsdeskriptors MemberDescriptor.Attributes . In der Regel sammelt der Eigenschaftsdeskriptor lokale Attribute und führt diese dann mit Attributen aus dem Eigenschaftentyp zusammen. In diesem Fall werden die Attribute aus dem Typ entnommen, der AttributeProviderAttributevom tatsächlichen Eigenschaftstyp zurückgegeben wird, nicht aus dem tatsächlichen Eigenschaftstyp. Dieses Attribut wird verwendet DataGridView.DataSource , um auf den spezifischen Typ des DataGridView.DataSource Objekts zu IListSourceverweisen, und die entsprechenden Metadaten werden aktiviert IListSource , um die Datenbindung zu aktivieren. Auf diese Weise können externe Parteien ganz einfach Metadaten zu allen Datenquellen hinzufügen.

Attribute, die von einem in der AttributeProviderAttribute Eigenschaft deklarierten Typ erhalten werden, haben eine Priorität zwischen den Attributen des Eigenschaftstyps und den Attributen für die Eigenschaft. Die folgende Liste in der Prioritätsreihenfolge zeigt den vollständigen Satz der verfügbaren zusammengeführten Attribute an:

• Eigenschaftsattribute

• Attributanbieterattribute

• Eigenschaftstypattribute

Weitere Informationen

• TypeDescriptor
• Übersicht über typdeskriptor