DesignOnlyAttribute Classe

Definição

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

Herança

Object

Attribute

DesignOnlyAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir cria uma GetLanguage propriedade . A propriedade é marcada com um 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

O exemplo a seguir obtém o valor do DesignOnlyAttribute. Primeiro, o código obtém um PropertyDescriptorCollection com todas as propriedades do objeto . Em seguida, ele indexa no PropertyDescriptorCollection para localizar a GetLanguage propriedade . Em seguida, ele retorna os atributos dessa propriedade e os salva na variável de atributos.

Em seguida, o exemplo imprime se a propriedade é design apenas recuperando do e gravando-a DesignOnlyAttributeAttributeCollectionna tela do 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()))

Comentários

Os membros marcados com o DesignOnlyAttribute definido como true só podem ser definidos em tempo de design. Normalmente, essas propriedades existem apenas em tempo de design e não correspondem a uma propriedade real no objeto em tempo de execução.

Os membros que não têm atributo ou são marcados com o DesignOnlyAttribute definido como false podem ser definidos durante o tempo de execução. O padrão é false.

Uma propriedade com o DesignOnlyAttribute definido como true tem seu valor serializado para o arquivo .resx em vez do InitializeComponent método .

Para obter mais informações, consulte Atributos.

Construtores

Campos

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

• Attribute
• PropertyDescriptor