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

DesignOnlyAttribute-Klasse

 

Veröffentlicht: Oktober 2016

Gibt an, ob eine Eigenschaft nur zur Entwurfszeit festgelegt werden kann.

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

System.Object
  System.Attribute
    System.ComponentModel.DesignOnlyAttribute

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

NameBeschreibung
System_CAPS_pubmethodDesignOnlyAttribute(Boolean)

Initialisiert eine neue Instanz der DesignOnlyAttribute-Klasse.

NameBeschreibung
System_CAPS_pubpropertyIsDesignOnly

Ruft einen Wert, der angibt, ob eine Eigenschaft nur zur Entwurfszeit festgelegt werden kann.

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 DesignOnlyAttribute.(Überschreibt Attribute.Equals(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()

Bestimmt, ob dieses Attribut der Standardwert ist.(Ü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_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 den DesignOnlyAttribute, also No. Diese static Feld ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticNo

Gibt an, dass eine Eigenschaft zur Entwurfszeit oder zur Laufzeit festgelegt werden kann. Diese static Feld ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticYes

Gibt an, dass eine Eigenschaft nur zur Entwurfszeit festgelegt werden kann. 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“.)

Member gekennzeichnet, mit der DesignOnlyAttribute festgelegt true kann nur zur Entwurfszeit festgelegt werden. In der Regel werden diese Eigenschaften nur zur Entwurfszeit vorhanden und entsprechen nicht definierten Eigenschaft des Objekts zur Laufzeit.

Member, die entweder kein Attribut aufweisen oder mit gekennzeichnet sind die DesignOnlyAttribute festgelegt false kann während der Laufzeit festgelegt werden. Die Standardeinstellung ist false.

Eine Eigenschaft mit dem DesignOnlyAttribute festgelegt true verfügt über einen Wert in die RESX-Datei anstelle von serialisiert die InitializeComponent Methode.

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

Das folgende Beispiel erstellt eine GetLanguage Eigenschaft. Die Eigenschaft wird markiert, mit einem DesignOnlyAttribute.

[DesignOnly(true)]
 public CultureInfo GetLanguage {
    get {
       // Insert code here.
       return myCultureInfo;
    }
    set {
       // Insert code here.
    }
 }

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

Im Beispiel wird dann, ob die Eigenschaft Entwurf nur durch das Abrufen von DesignOnlyAttribute aus der AttributeCollection, und sie in das Konsolenfenster geschrieben.

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

 /* Prints whether the property is marked as DesignOnly 
  * by retrieving the DesignOnlyAttribute from the AttributeCollection. */
 DesignOnlyAttribute myAttribute = 
    (DesignOnlyAttribute)attributes[typeof(DesignOnlyAttribute)];
 Console.WriteLine("This property is design only :" +
    myAttribute.IsDesignOnly.ToString());

.NET Framework
Verfügbar seit 1.1

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: