Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DesignOnlyAttribute

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

System.Object
  System.Attribute
    System.ComponentModel.DesignOnlyAttribute

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

NombreDescripción
System_CAPS_pubmethodDesignOnlyAttribute(Boolean)

Inicializa una nueva instancia de la clase DesignOnlyAttribute.

NombreDescripción
System_CAPS_pubpropertyIsDesignOnly

Obtiene un valor que indica si una propiedad puede establecerse sólo en tiempo de diseño.

System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Devuelve si el valor del objeto especificado es igual a la actual DesignOnlyAttribute.(Invalida Attribute.Equals(Object)).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Invalida Attribute.GetHashCode()).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Determina si este atributo es el valor predeterminado.(Invalida Attribute.IsDefaultAttribute()).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticDefault

Especifica el valor predeterminado para el DesignOnlyAttribute, que es No. Esto static campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticNo

Especifica que se puede establecer una propiedad en tiempo de diseño o en tiempo de ejecución. Esto static campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticYes

Especifica que una propiedad puede establecerse sólo en tiempo de diseño. Esto static campo es de solo lectura.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

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

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

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

Para obtener más información, consulta Extender metadatos mediante atributos.

En el ejemplo siguiente se crea un GetLanguage propiedad. La propiedad se marca con un DesignOnlyAttribute.

[DesignOnly(true)]
 public CultureInfo GetLanguage {
    get {
       // Insert code here.
       return myCultureInfo;
    }
    set {
       // Insert code here.
    }
 }

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

A continuación, se imprime si la propiedad es el diseño mediante la recuperación de DesignOnlyAttribute desde el AttributeCollection, y escribir 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 = 
    (DesignOnlyAttribute)attributes[typeof(DesignOnlyAttribute)];
 Console.WriteLine("This property is design only :" +
    myAttribute.IsDesignOnly.ToString());

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: