DesignerCategoryAttribute Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DesignerCategoryAttribute, classe

 

Spécifie que le concepteur pour une classe appartient à une certaine catégorie.

Espace de noms:   System.ComponentModel
Assembly:  System (dans System.dll)

System.Object
  System.Attribute
    System.ComponentModel.DesignerCategoryAttribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = false, 
	Inherited = true)]
public sealed class DesignerCategoryAttribute : Attribute

NomDescription
System_CAPS_pubmethodDesignerCategoryAttribute()

Initialise une nouvelle instance de la DesignerCategoryAttribute classe avec une chaîne vide (« »).

System_CAPS_pubmethodDesignerCategoryAttribute(String)

Initialise une nouvelle instance de la DesignerCategoryAttribute classe avec le nom de catégorie donné.

NomDescription
System_CAPS_pubpropertyCategory

Obtient le nom de la catégorie.

System_CAPS_pubpropertyTypeId

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient un identificateur unique pour cet attribut.(Remplace Attribute.TypeId.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Retourne si la valeur de l'objet donné est égale à le DesignOnlyAttribute.(Remplace Attribute.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Retourne le code de hachage de cette instance.(Remplace Attribute.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodIsDefaultAttribute()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Détermine si cet attribut est la valeur par défaut.(Remplace Attribute.IsDefaultAttribute().)

System_CAPS_pubmethodMatch(Object)

En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance équivaut à un objet spécifié.(Hérité de Attribute.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticComponent

Spécifie qu'un composant de cette catégorie utilise un concepteur de composants. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticDefault

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Spécifie qu'un composant de cette catégorie ne peut pas utiliser un concepteur visuel. Cela static champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticForm

Spécifie qu'un composant de cette catégorie utilise un concepteur de formulaires. Cela static champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticGeneric

Spécifie qu'un composant de cette catégorie utilise un Concepteur générique. Cela static champ est en lecture seule.

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

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface.(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).(Hérité de Attribute.)

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

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.(Hérité de Attribute.)

Un concepteur visuel peut utiliser une catégorie de concepteur pour informer un environnement de développement du type de concepteur qui sera implémenté. Si aucune catégorie de concepteur n'est fourni sur une classe, un environnement de développement peut ou non autoriser la classe. Une catégorie peut être créée pour n'importe quel nom.

Lorsque vous marquez une classe avec cet attribut, il est défini à un membre de constante. Lorsque vous souhaitez vérifier la valeur de cet attribut dans votre code, vous devez spécifier le membre de constante. La colonne Description dans le tableau ci-dessous répertorie les membres de constante chaque valeur.

La DesignerCategoryAttribute classe définit les catégories communes suivantes :

Catégorie

Description

Composant

Concepteurs qui sont utilisés avec des composants. L'attribut a la valeur du membre de constante DesignerCategoryAttribute.Component.

Formulaire

Concepteurs qui sont utilisés avec des formulaires. L'attribut a la valeur du membre de constante DesignerCategoryAttribute.Form.

Designer

Concepteurs qui sont utilisés avec les concepteurs. L'attribut a la valeur du membre de constante DesignerCategoryAttribute.Generic.

Une chaîne vide (« »)

Il s'agit de la catégorie par défaut.

Pour plus d'informations, consultez Extension des métadonnées à l'aide des attributs.

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

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]

 public class MyForm : ContainerControl {
    // Insert code here.
 }

L'exemple suivant crée une instance de MyForm. Il obtient ensuite les attributs de la classe, extrait le DesignerCategoryAttribute, et imprime le nom du concepteur.

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 
     * DesignerCategoryAttribute from the AttributeCollection. */
    DesignerCategoryAttribute myAttribute = 
       (DesignerCategoryAttribute)attributes[typeof(DesignerCategoryAttribute)];
    Console.WriteLine("The category of the designer for this class is: " + myAttribute.Category);

    return 0;
}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft