DesignOnlyAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Source:

DesignOnlyAttribute.cs

Specifica se una proprietà può essere impostata solo in fase di progettazione.

public ref class DesignOnlyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class DesignOnlyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type DesignOnlyAttribute = class
    inherit Attribute

Public NotInheritable Class DesignOnlyAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

DesignOnlyAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene creata una GetLanguage proprietà. La proprietà è contrassegnata con un DesignOnlyAttributeoggetto .

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'esempio DesignOnlyAttributesuccessivo ottiene il valore di . Prima di tutto il codice ottiene un PropertyDescriptorCollection oggetto con tutte le proprietà per l'oggetto. Successivamente indicizza nell'oggetto PropertyDescriptorCollection per trovare la GetLanguage proprietà. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile attributi.

L'esempio stampa quindi se la proprietà è progettata solo recuperando DesignOnlyAttribute dall'oggetto AttributeCollectione scrivendola nella schermata della 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()))

Commenti

I membri contrassegnati con il DesignOnlyAttribute set su true possono essere impostati solo in fase di progettazione. In genere, queste proprietà esistono solo in fase di progettazione e non corrispondono a una proprietà reale sull'oggetto in fase di esecuzione.

I membri che non hanno attributi o sono contrassegnati con il set da false impostare durante l'esecuzioneDesignOnlyAttribute. Il valore predefinito è false.

Una proprietà con l'oggetto DesignOnlyAttribute impostato su true ha il relativo valore serializzato nel file con estensione resx anziché nel InitializeComponent metodo .

Per altre informazioni, vedere Attributi.

Costruttori

DesignOnlyAttribute(Boolean)

Inizializza una nuova istanza della classe DesignOnlyAttribute.

Campi

Default	Consente di specificare il valore predefinito per l'attributo DesignOnlyAttribute, che è No. Questo campo static è di sola lettura.
No	Specifica che una proprietà può essere impostata in fase di progettazione o in fase di esecuzione. Questo campo static è di sola lettura.
Yes	Specifica che una proprietà può essere impostata solo in fase di progettazione. Questo campo static è di sola lettura.

Proprietà

IsDesignOnly	Ottiene un valore che indica se una proprietà può essere impostata solo in fase di progettazione.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Specifica se il valore dell'oggetto specificato è uguale all'oggetto DesignOnlyAttribute corrente.
GetHashCode()	Restituisce il codice hash per l'istanza.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	Determina se questo attributo è predefinito.
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Attribute
• PropertyDescriptor