DesignOnlyAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.Primitives.dll

Source:

DesignOnlyAttribute.cs

Especifica si una propiedad sólo se puede establecer en tiempo de diseño.

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

Herencia

Object

Attribute

DesignOnlyAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se crea una GetLanguage propiedad . La propiedad está marcada con .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

En el ejemplo siguiente se obtiene el valor de DesignOnlyAttribute. En primer lugar, el código obtiene con PropertyDescriptorCollection todas las propiedades del objeto . A continuación, se indexa en para PropertyDescriptorCollection buscar la GetLanguage propiedad . A continuación, devuelve los atributos de esta propiedad y los guarda en la variable attributes.

A continuación, en el ejemplo se imprime si la propiedad solo se diseña recuperando DesignOnlyAttribute de AttributeCollectiony escribiendola en la pantalla de la consola.

// 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()))

Comentarios

Los miembros marcados con el DesignOnlyAttribute conjunto en true solo se pueden establecer en tiempo de diseño. Normalmente, estas propiedades solo existen en tiempo de diseño y no corresponden a una propiedad real en el objeto en tiempo de ejecución.

Los miembros que no tienen ningún atributo o están marcados con el valor establecido false en se pueden establecer durante el DesignOnlyAttribute tiempo de ejecución. De manera predeterminada, es false.

Una propiedad con el DesignOnlyAttribute valor establecido true en tiene su valor serializado en el archivo .resx en lugar del InitializeComponent método .

Para obtener más información, consulte Attributes (Atributos).

Constructores

DesignOnlyAttribute(Boolean)

Inicializa una nueva instancia de la clase DesignOnlyAttribute.

Campos

Default	Especifica el valor predeterminado de DesignOnlyAttribute, que es No. Este campo static es de solo lectura.
No	Especifica que una propiedad puede establecerse en tiempo de diseño o en tiempo de ejecución. Este campo static es de solo lectura.
Yes	Especifica que una propiedad sólo se puede establecer en tiempo de diseño. Este campo static es de solo lectura.

Propiedades

IsDesignOnly	Obtiene un valor que indica si una propiedad sólo se puede establecer en tiempo de diseño.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si el valor del objeto especificado es igual al atributo DesignOnlyAttribute actual.
GetHashCode()	Devuelve el código hash de esta instancia.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Determina si este atributo es el valor predeterminado.
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• Attribute
• PropertyDescriptor