Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DescriptionAttribute-Klasse

 

Veröffentlicht: Oktober 2016

Gibt eine Beschreibung für eine Eigenschaft oder ein Ereignis.

Namespace:   System.ComponentModel
Assembly:  System (in System.dll)


[AttributeUsageAttribute(AttributeTargets.All)]
public class DescriptionAttribute : Attribute

NameBeschreibung
System_CAPS_pubmethodDescriptionAttribute()

Initialisiert eine neue Instanz der DescriptionAttribute -Klasse ohne Parameter.

System_CAPS_pubmethodDescriptionAttribute(String)

Initialisiert eine neue Instanz der DescriptionAttribute -Klasse mit einer Beschreibung.

NameBeschreibung
System_CAPS_pubpropertyDescription

Ruft die Beschreibung in diesem Attribut gespeichert.

System_CAPS_protpropertyDescriptionValue

Ruft ab oder legt die Zeichenfolge als Beschreibung gespeichert.

System_CAPS_pubpropertyTypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Gibt zurück, ob der Wert des angegebenen Objekts gleich dem aktuellen DescriptionAttribute.(Überschreibt Attribute.Equals(Object).)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Überschreibt Attribute.GetHashCode().)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsDefaultAttribute()

Gibt einen Wert, der angibt, ob dies der Standardwert ist DescriptionAttribute Instanz.(Überschreibt Attribute.IsDefaultAttribute().)

System_CAPS_pubmethodMatch(Object)

Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubfieldSystem_CAPS_staticDefault

Gibt den Standardwert für die DescriptionAttribute, dies ist eine leere Zeichenfolge (""). Diese static Feld ist schreibgeschützt.

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

Ein visueller Designer kann die angegebene Beschreibung anzeigen, bei der, wie z. B. in einem Eigenschaftenfenster Komponentenmember. Rufen Sie Description Zugriff auf den Wert dieses Attributs.

Weitere Informationen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Das folgende Beispiel erstellt die MyImage Eigenschaft. Die Eigenschaft verfügt über zwei Attribute einer DescriptionAttribute und einem CategoryAttribute.

[Description("The image associated with the control"),Category("Appearance")] 
 public Image MyImage {
    get {
       // Insert code here.
       return image1;
    }
    set {
       // Insert code here.
    }
 }

Im nächsten Beispiel wird die Beschreibung des MyImage. Zunächst wird ein PropertyDescriptorCollection mit allen Eigenschaften für das Objekt. Als Nächstes werden indiziert in der PropertyDescriptorCollection abzurufenden MyImage. Anschließend werden die Attribute für diese Eigenschaft zurückgegeben und in der Attributes-Variablen gespeichert.

Das Beispiel gibt die Beschreibung dann durch das Abrufen von DescriptionAttribute aus der AttributeCollection, und sie in das Konsolenfenster geschrieben.

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyImage"].Attributes;

 /* Prints the description by retrieving the DescriptionAttribute 
  * from the AttributeCollection. */
 DescriptionAttribute myAttribute = 
    (DescriptionAttribute)attributes[typeof(DescriptionAttribute)];
 Console.WriteLine(myAttribute.Description);

.NET Framework
Verfügbar seit 1.1
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: