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 RecommendedAsConfigurableAttribute

 

Publicado: octubre de 2016

obsoleteCodeEntityT:System.ComponentModel.SettingsBindableAttribute Nota: Esta API ahora está obsoleta.

Especifica que la propiedad se puede usar como configuración de la aplicación.

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

System.Object
  System.Attribute
    System.ComponentModel.RecommendedAsConfigurableAttribute

[AttributeUsageAttribute(AttributeTargets.Property)]
[ObsoleteAttribute("Use System.ComponentModel.SettingsBindableAttribute instead to work with the new settings model.")]
public class RecommendedAsConfigurableAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodRecommendedAsConfigurableAttribute(Boolean)

Inicializa una nueva instancia de la clase RecommendedAsConfigurableAttribute.

NombreDescripción
System_CAPS_pubpropertyRecommendedAsConfigurable

Obtiene un valor que indica si la propiedad que está enlazado este atributo para que puede utilizarse como configuración de la aplicación.

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)

Indica si esta instancia y un objeto especificado son iguales.(Invalida Attribute.Equals(Object)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de 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()

Indica si el valor de esta instancia es el valor predeterminado de la clase.(Invalida Attribute.IsDefaultAttribute()).

System_CAPS_pubmethodMatch(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).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

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

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticDefault

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

System_CAPS_pubfieldSystem_CAPS_staticNo

Especifica que una propiedad no puede utilizarse como configuración de la aplicación. Esto static campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticYes

Especifica que una propiedad se puede usar como configuración de la aplicación. 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 de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona 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).

Las propiedades marcadas con el RecommendedAsConfigurableAttribute establecido en true Mostrar cuando se expande el ConfigurableProperties de línea en el propiedades ventana. Una propiedad que no tiene ningún valor recomendado o que esté marcada con RecommendedAsConfigurableAttribute establecido en false no se muestra y probablemente de una configuración de aplicación. De manera predeterminada, es false.

Puede enlazar una propiedad que no tiene una RecommendedAsConfigurableAttribute a una configuración en Visual Studio, haga clic en el botón de puntos suspensivos (...) bajo configuración en el propiedades ventana y seleccionando la propiedad correspondiente de la lista.

System_CAPS_noteNota

Al marcar una propiedad con RecommendedAsConfigurableAttribute establecido en true, el valor de este atributo se establece en el miembro constante Yes. Para una propiedad marcada con RecommendedAsConfigurableAttribute establecido en el valor false, el valor es No. Por lo tanto, cuando desee comprobar el valor de este atributo en el código, debe especificar el atributo como RecommendedAsConfigurableAttribute.Yes o RecommendedAsConfigurableAttribute.No.

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

.

En el ejemplo siguiente se marca una propiedad como se pueden usar como configuración de la aplicación.

[RecommendedAsConfigurable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }

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

En este ejemplo se muestra dos formas diferentes de comprobar el valor de la RecommendedAsConfigurableAttribute. En el segundo fragmento de código, se llama el Equals método. En el último fragmento de código, se utiliza el RecommendedAsConfigurable propiedad para comprobar el valor.

// Gets the attributes for the property.
AttributeCollection attributes = 
   TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;

// Checks to see if the value of the RecommendedAsConfigurableAttribute is Yes.
if(attributes[typeof(RecommendedAsConfigurableAttribute)].Equals(RecommendedAsConfigurableAttribute.Yes)) {
   // Insert code here.
}

// This is another way to see if the property is recommended as configurable.
RecommendedAsConfigurableAttribute myAttribute = 
   (RecommendedAsConfigurableAttribute)attributes[typeof(RecommendedAsConfigurableAttribute)];
if(myAttribute.RecommendedAsConfigurable) {
   // Insert code here.
}

Si se marcó una clase con el RecommendedAsConfigurableAttribute, utilice el código siguiente para comprobar el valor.

AttributeCollection attributes = 
   TypeDescriptor.GetAttributes(MyProperty);
if(attributes[typeof(RecommendedAsConfigurableAttribute)].Equals(RecommendedAsConfigurableAttribute.Yes)) {
   // Insert code here.
}

.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: