TypeDescriptor.GetAttributes Methode

  • Referenz

Definition

Namespace:
System.ComponentModel
Assembly:
System.ComponentModel.TypeConverter.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Gibt die Auflistung von Attributen für eine Komponente oder einen Typ zurück.

Überlädt

GetAttributes(Object)

Gibt eine Auflistung von Attributen für die angegebene Komponente zurück.
GetAttributes(Type)

Gibt eine Auflistung von Attributen für den angegebenen Typ der Komponente zurück.
GetAttributes(Object, Boolean)

Gibt eine Auflistung von Attributen für die angegebene Komponente und einen booleschen Wert zurück, der angibt, dass ein Deskriptor mit benutzerdefiniertem Typ erstellt wurde.

GetAttributes(Object)

Quelle:
TypeDescriptor.cs
Quelle:
TypeDescriptor.cs
Quelle:
TypeDescriptor.cs

Gibt eine Auflistung von Attributen für die angegebene Komponente zurück.

public:
 static System::ComponentModel::AttributeCollection ^ GetAttributes(System::Object ^ component);
public static System.ComponentModel.AttributeCollection GetAttributes (object component);
static member GetAttributes : obj -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (component As Object) As AttributeCollection

Parameter

component
Object

Die Komponente, für die Sie Attribute abrufen möchten.

Gibt zurück

AttributeCollection

Eine AttributeCollection, die die Attribute für diese Komponente enthält. Wenn componentnull ist, gibt diese Methode eine leere Auflistung zurück.

Beispiele

Ein Beispiel für diese Methode finden Sie in der Matches -Methode.

Hinweise

Die von der GetAttributes -Methode zurückgegebenen Attribute können dynamisch aus der Quellliste der ursprünglichen Komponente durch Extenderanbieter (), Filterdienste (IExtenderProviderITypeDescriptorFilterService) und Attributfilter geändert werden.

Wenn Sie ein benutzerdefiniertes Attribut definieren, das AttributeUsageAttribute.AllowMultiple auf truefestgelegt ist, müssen Sie die Attribute.TypeId -Eigenschaft überschreiben, um sie eindeutig zu machen. Wenn alle Instanzen Ihres Attributs eindeutig sind, überschreiben Attribute.TypeId Sie, um die Objektidentität Ihres Attributs zurückzugeben. Wenn nur einige Instanzen Ihres Attributs eindeutig sind, geben Sie einen Wert von zurück, der Attribute.TypeId in diesen Fällen die Gleichheit zurückgeben würde. Einige Attribute verfügen beispielsweise über einen Konstruktorparameter, der als eindeutiger Schlüssel fungiert. Geben Sie für diese Attribute den Wert des Konstruktorparameters aus der Attribute.TypeId -Eigenschaft zurück.

Hinweis

Die Standardimplementierung von Attribute.TypeId gibt die Typidentität unabhängig vom Wert der AttributeUsageAttribute.AllowMultiple Eigenschaft zurück. Um mehrere Instanzen eines AttributeUsageAttribute.AllowMultiple Attributs von AttributeCollectionzurückzugeben, muss Ihr Attribut die Attribute.TypeId -Eigenschaft überschreiben.

Weitere Informationen

Gilt für:

GetAttributes(Type)

Quelle:
TypeDescriptor.cs
Quelle:
TypeDescriptor.cs
Quelle:
TypeDescriptor.cs

Gibt eine Auflistung von Attributen für den angegebenen Typ der Komponente zurück.

public:
 static System::ComponentModel::AttributeCollection ^ GetAttributes(Type ^ componentType);
public static System.ComponentModel.AttributeCollection GetAttributes (Type componentType);
static member GetAttributes : Type -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (componentType As Type) As AttributeCollection

Parameter

componentType
Type

Der Type der Zielkomponente.

Gibt zurück

AttributeCollection

Ein AttributeCollection mit den Attributen für den Typ der Komponente. Wenn die Komponente null ist, gibt diese Methode eine leere Auflistung zurück.

Hinweise

Rufen Sie diese Version dieser Methode nur auf, wenn Sie nicht über eine instance des -Objekts verfügen.

Bei Attributen, deren AttributeUsageAttribute.AllowMultiple Wert auf truefestgelegt ist, entfernt die Attributauflistung doppelte Instanzen. Dies sind Instanzen, in denen die Attribute.TypeId -Eigenschaft gleiche Werte zurückgibt.

Wenn Sie ein benutzerdefiniertes Attribut definieren, das AttributeUsageAttribute.AllowMultiple auf truefestgelegt ist, müssen Sie die Attribute.TypeId -Eigenschaft überschreiben, um sie eindeutig zu machen. Wenn alle Instanzen Ihres Attributs eindeutig sind, überschreiben Attribute.TypeId Sie, um die Objektidentität Ihres Attributs zurückzugeben. Wenn nur einige Instanzen Ihres Attributs eindeutig sind, geben Sie einen Wert von zurück, der Attribute.TypeId in diesen Fällen die Gleichheit zurückgeben würde. Einige Attribute verfügen beispielsweise über einen Konstruktorparameter, der als eindeutiger Schlüssel fungiert. Geben Sie für diese Attribute den Wert des Konstruktorparameters aus der Attribute.TypeId -Eigenschaft zurück.

Hinweis

Die Standardimplementierung von Attribute.TypeId gibt die Typidentität unabhängig vom Wert der AttributeUsageAttribute.AllowMultiple Eigenschaft zurück. Um mehrere Instanzen eines AttributeUsageAttribute.AllowMultiple Attributs von AttributeCollectionzurückzugeben, muss Ihr Attribut die Attribute.TypeId -Eigenschaft überschreiben.

Weitere Informationen

Gilt für:

GetAttributes(Object, Boolean)

Quelle:
TypeDescriptor.cs
Quelle:
TypeDescriptor.cs
Quelle:
TypeDescriptor.cs

Gibt eine Auflistung von Attributen für die angegebene Komponente und einen booleschen Wert zurück, der angibt, dass ein Deskriptor mit benutzerdefiniertem Typ erstellt wurde.

public:
 static System::ComponentModel::AttributeCollection ^ GetAttributes(System::Object ^ component, bool noCustomTypeDesc);
public static System.ComponentModel.AttributeCollection GetAttributes (object component, bool noCustomTypeDesc);
static member GetAttributes : obj * bool -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (component As Object, noCustomTypeDesc As Boolean) As AttributeCollection

Parameter

component
Object

Die Komponente, für die Sie Attribute abrufen möchten.

noCustomTypeDesc
Boolean

true, um einen Basissatz von Attributen des benutzerdefinierten Typdeskriptors zu verwenden, wenn component den Typ ICustomTypeDescriptor besitzt, andernfalls false.

Gibt zurück

AttributeCollection

Ein AttributeCollection mit den Attributen für die Komponente. Wenn die Komponente null ist, gibt diese Methode eine leere Auflistung zurück.

Hinweise

Die von der GetAttributes -Methode zurückgegebenen Attribute können dynamisch von der ursprünglichen Quellliste der Komponenten durch Extenderanbieter (IExtenderProvider), Filterdienste (ITypeDescriptorFilterService) und Attributfilter geändert werden.

Wenn Sie ein benutzerdefiniertes Attribut definieren, das AttributeUsageAttribute.AllowMultiple auf truefestgelegt ist, müssen Sie die Attribute.TypeId -Eigenschaft überschreiben, um sie eindeutig zu machen. Wenn alle Instanzen Ihres Attributs eindeutig sind, überschreiben Attribute.TypeId Sie, um die Objektidentität Ihres Attributs zurückzugeben. Wenn nur einige Instanzen Ihres Attributs eindeutig sind, geben Sie einen Wert von zurück, der Attribute.TypeId in diesen Fällen die Gleichheit zurückgeben würde. Einige Attribute verfügen beispielsweise über einen Konstruktorparameter, der als eindeutiger Schlüssel fungiert. Geben Sie für diese Attribute den Wert des Konstruktorparameters aus der Attribute.TypeId -Eigenschaft zurück.

Hinweis

Die Standardimplementierung von Attribute.TypeId gibt die Typidentität unabhängig vom Wert der AttributeUsageAttribute.AllowMultiple Eigenschaft zurück. Um mehrere Instanzen eines AttributeUsageAttribute.AllowMultiple Attributs von AttributeCollectionzurückzugeben, muss Ihr Attribut die Attribute.TypeId -Eigenschaft überschreiben.

Weitere Informationen

Gilt für: