DesignOnlyAttribute Classe

Definizione

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
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
Ereditarietà
DesignOnlyAttribute
Attributi

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.

IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
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)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.

(Ereditato da Attribute)

Si applica a

Vedi anche