DesignOnlyAttribute Classe

Définition

Spécifie si une propriété ne peut être définie qu'au moment du design.

public ref class DesignOnlyAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class DesignOnlyAttribute : Attribute
public sealed class DesignOnlyAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All)>]
type DesignOnlyAttribute = class
    inherit Attribute
type DesignOnlyAttribute = class
    inherit Attribute
Public NotInheritable Class DesignOnlyAttribute
Inherits Attribute
Héritage
DesignOnlyAttribute
Attributs

Exemples

L’exemple suivant crée une GetLanguage propriété . La propriété est marquée avec un DesignOnlyAttribute.

public:
   [DesignOnly(true)]
   property CultureInfo^ GetLanguage 
   {
      CultureInfo^ get()
      {
         // Insert code here.
         return myCultureInfo;
      }
      void set( CultureInfo^ value )
      {
         // Insert code here.
      }
   }
[DesignOnly(true)]
 public CultureInfo GetLanguage {
    get {
       // Insert code here.
       return myCultureInfo;
    }
    set {
       // Insert code here.
    }
 }
<DesignOnly(True)> _
Public Property GetLanguage() As CultureInfo
    Get
        ' Insert code here.
        Return myCultureInfo
    End Get
    Set
        ' Insert code here.
    End Set
End Property

L’exemple suivant obtient la valeur de .DesignOnlyAttribute Tout d’abord, le code obtient un PropertyDescriptorCollection avec toutes les propriétés de l’objet . Ensuite, il s’indexe dans pour PropertyDescriptorCollection rechercher la GetLanguage propriété . Ensuite, il retourne les attributs de cette propriété et les enregistre dans la variable d’attributs.

L’exemple indique ensuite si la propriété est de conception uniquement en récupérant à partir de AttributeCollectionet en l’écrivant DesignOnlyAttribute sur l’écran de la console.

// 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 = dynamic_cast<DesignOnlyAttribute^>(attributes[ DesignOnlyAttribute::typeid ]);
Console::WriteLine( "This property is design only :{0}", myAttribute->IsDesignOnly );
// 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());
' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("GetLanguage").Attributes

' Prints whether the property is marked as DesignOnly 
' by retrieving the DesignOnlyAttribute from the AttributeCollection.
Dim myAttribute As DesignOnlyAttribute = _
    CType(attributes(GetType(DesignOnlyAttribute)), DesignOnlyAttribute)
Console.WriteLine(("This property is design only :" & _
    myAttribute.IsDesignOnly.ToString()))

Remarques

Les membres marqués avec l’ensemble DesignOnlyAttribute sur true peuvent être définis uniquement au moment du design. En règle générale, ces propriétés existent uniquement au moment du design et ne correspondent pas à une propriété réelle sur l’objet au moment de l’exécution.

Les membres qui n’ont pas d’attribut ou qui sont marqués avec le DesignOnlyAttribute défini false sur peuvent être définis pendant l’exécution. La valeur par défaut est false.

Une propriété dont la DesignOnlyAttribute valeur est définie true sur a sa valeur sérialisée dans le fichier .resx au lieu de la InitializeComponent méthode .

Pour plus d’informations, consultez Attributs.

Constructeurs

DesignOnlyAttribute(Boolean)

Initialise une nouvelle instance de la classe DesignOnlyAttribute.

Champs

Default

Spécifie la valeur par défaut de DesignOnlyAttribute (No). Ce champ static est en lecture seule.

No

Spécifie qu'une propriété peut être définie au moment du design ou de l'exécution. Ce champ static est en lecture seule.

Yes

Spécifie qu'une propriété ne peut être définie qu'au moment du design. Ce champ static est en lecture seule.

Propriétés

IsDesignOnly

Obtient une valeur indiquant si une propriété ne peut être définie qu'au moment du design.

TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.

(Hérité de Attribute)

Méthodes

Equals(Object)

Retourne une valeur indiquant si la valeur de l'objet donné est égale au DesignOnlyAttribute en cours.

GetHashCode()

Retourne le code de hachage de cette instance.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
IsDefaultAttribute()

Détermine si cet attribut est l'attribut par défaut.

IsDefaultAttribute()

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée.

(Hérité de Attribute)
Match(Object)

En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié.

(Hérité de Attribute)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.

(Hérité de Attribute)
_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)
_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)
_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)

S’applique à

Voir aussi