DesignerAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Quelle:

DesignerAttribute.cs

Gibt die Klasse an, die zum Implementieren von Entwurfszeitdiensten für eine Komponente verwendet wird.

public ref class DesignerAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true, Inherited=true)]
public sealed class DesignerAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true, Inherited=true)>]
type DesignerAttribute = class
    inherit Attribute

Public NotInheritable Class DesignerAttribute
Inherits Attribute

Vererbung

Object

Attribute

DesignerAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird eine Klasse namens MyFormerstellt. MyForm verfügt über zwei Attribute, ein DesignerAttribute , das angibt, dass diese Klasse verwendet DocumentDesigner, und ein , DesignerCategoryAttribute das die Form Kategorie angibt.

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL",
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL", 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]
public class MyForm : ContainerControl {
    // Insert code here.
}

<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL", _
    GetType(IRootDesigner)), DesignerCategory("Form")> _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class

Im nächsten Beispiel wird eine instance von MyFormerstellt. Anschließend werden die Attribute für die -Klasse abgerufen, extrahiert und DesignerAttributeder Name des Designers ausgegeben.

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the DesignerAttribute
       * from the AttributeCollection. */
   DesignerAttribute^ myAttribute = dynamic_cast<DesignerAttribute^>(attributes[ DesignerAttribute::typeid ]);
   Console::WriteLine( "The designer for this class is: {0}", myAttribute->DesignerTypeName );
   return 0;
}

public static int Main() {
    // Creates a new form.
    MyForm myNewForm = new MyForm();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);
 
    /* Prints the name of the designer by retrieving the DesignerAttribute
     * from the AttributeCollection. */
    DesignerAttribute myAttribute = 
       (DesignerAttribute)attributes[typeof(DesignerAttribute)];
    Console.WriteLine("The designer for this class is: " + myAttribute.DesignerTypeName);
  
    return 0;
}

Public Shared Function Main() As Integer
    ' Creates a new form.
    Dim myNewForm As New MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the DesignerAttribute
    ' from the AttributeCollection. 
    Dim myAttribute As DesignerAttribute = _
        CType(attributes(GetType(DesignerAttribute)), DesignerAttribute)
    Console.WriteLine(("The designer for this class is: " & myAttribute.DesignerTypeName))
    
    Return 0
End Function 'Main

Hinweise

Die Klasse, die Sie für die Entwurfszeitdienste verwenden, muss die IDesigner -Schnittstelle implementieren.

Verwenden Sie die DesignerBaseTypeName -Eigenschaft, um den Basistyp des Designers zu ermitteln. Verwenden Sie die DesignerTypeName -Eigenschaft, um den Namen des Designertyps abzurufen, der diesem Member zugeordnet ist.

Weitere Informationen finden Sie unter Attribute.

Konstruktoren

DesignerAttribute(String)	Initialisiert eine neue Instanz der DesignerAttribute-Klasse mit dem Namen des Typs, der Entwurfszeitdienste bereitstellt.
DesignerAttribute(String, String)	Initialisiert eine neue Instanz der DesignerAttribute-Klasse mit dem Designertyp und der Basisklasse des Designers.
DesignerAttribute(String, Type)	Initialisiert eine neue Instanz der DesignerAttribute-Klasse mit dem Namen der Designerklasse sowie der Basisklasse des Designers.
DesignerAttribute(Type)	Initialisiert eine neue Instanz der DesignerAttribute-Klasse unter Verwendung des Typs, der Entwurfszeitdienste bereitstellt.
DesignerAttribute(Type, Type)	Initialisiert eine neue Instanz der DesignerAttribute-Klasse mit den Typen des Designers und der Designerbasisklasse.

Eigenschaften

DesignerBaseTypeName	Ruft den Namen des Basistyps dieses Designers ab.
DesignerTypeName	Ruft den Namen des Designertyps ab, der diesem Designerattribut zugeordnet ist.
TypeId	Ruft eine eindeutige ID für diesen Attributtyp ab.

Methoden

Equals(Object)	Gibt zurück, ob der Wert des angegebenen Objekts gleich dem aktuellen DesignerAttribute ist.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Attribute