DesignOnlyAttribute Classe

Definizione

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à

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

Campi

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• Attribute
• PropertyDescriptor