DesignOnlyAttribute Classe

Définition

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

Object

Attribute

DesignOnlyAttribute

Attributs

AttributeUsageAttribute

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 concevoir uniquement en récupérant à partir de et AttributeCollectionen l’écrivant DesignOnlyAttribute dans 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 la DesignOnlyAttribute valeur sur true ne peuvent être définis qu’au moment de la conception. 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

Champs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• Attribute
• PropertyDescriptor