DesignerAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.Primitives.dll

Source:

DesignerAttribute.cs

Spécifie la classe utilisée pour implémenter des services au moment du design pour un composant.

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

Héritage

Object

Attribute

DesignerAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant crée une classe appelée MyForm. MyForm a deux attributs, un DesignerAttribute qui spécifie cette classe utilise le DocumentDesigner, et un DesignerCategoryAttribute qui spécifie la Form catégorie.

[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

L’exemple suivant crée une instance de MyForm. Ensuite, il obtient les attributs de la classe, extrait le DesignerAttribute, et imprime le nom du concepteur.

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();

    // 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

Remarques

La classe que vous utilisez pour les services au moment du design doit implémenter l’interface IDesigner .

Utilisez la DesignerBaseTypeName propriété pour rechercher le type de base du concepteur. Utilisez la DesignerTypeName propriété pour obtenir le nom du type de concepteur associé à ce membre.

Pour plus d’informations, consultez Attributs.

Constructeurs

Nom	Description
DesignerAttribute(String, String)	Initialise une nouvelle instance de la classe à l’aide DesignerAttribute du type de concepteur et de la classe de base pour le concepteur.
DesignerAttribute(String, Type)	Initialise une nouvelle instance de la DesignerAttribute classe, en utilisant le nom de la classe de concepteur et la classe de base pour le concepteur.
DesignerAttribute(String)	Initialise une nouvelle instance de la DesignerAttribute classe à l’aide du nom du type qui fournit des services au moment du design.
DesignerAttribute(Type, Type)	Initialise une nouvelle instance de la DesignerAttribute classe à l’aide des types de la classe de base du concepteur et du concepteur.
DesignerAttribute(Type)	Initialise une nouvelle instance de la classe à l’aide DesignerAttribute du type qui fournit des services au moment du design.

Propriétés

Nom	Description
DesignerBaseTypeName	Obtient le nom du type de base de ce concepteur.
DesignerTypeName	Obtient le nom du type de concepteur associé à cet attribut de concepteur.
TypeId	Obtient un ID unique pour ce type d’attribut.

Méthodes

Nom	Description
Equals(Object)	Retourne si la valeur de l’objet donné est égale à la valeur actuelle DesignerAttribute.
GetHashCode()	Retourne le code de hachage pour cette instance.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Attribute