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

RecommendedAsConfigurableAttribute (Clase)

 
obsoleteCodeEntityT:System.ComponentModel.SettingsBindableAttributeNota: esta API está ahora obsoleta.

Especifica que la propiedad se puede utilizar 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 a la que está enlazado este atributo se puede utilizar 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.(Reemplaza a Attribute.Equals(Object)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object.)

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Reemplaza a 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.(Reemplaza a 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_protmethodMemberwiseClone()

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

System_CAPS_pubmethodToString()

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

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticDefault

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

System_CAPS_pubfieldSystem_CAPS_staticNo

Especifica que no se puede utilizar una propiedad como configuración de la aplicación.Este campo static es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticYes

Especifica que una propiedad puede utilizarse como configuración de la aplicación.Este campo static 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.)

Se muestran las propiedades que están marcadas con RecommendedAsConfigurableAttribute establecido en true cuando se expande la línea ConfigurableProperties de la ventana Propiedades.Las propiedades que no tengan un valor recomendado o que estén marcadas con RecommendedAsConfigurableAttribute establecido en false no se mostrarán y probablemente no serán válidas como configuración de la aplicación.El valor predeterminado es false.

Para enlazar una propiedad que no tenga un objeto RecommendedAsConfigurableAttribute a un valor de Visual Studio, haga clic en el botón de puntos suspensivos (…) bajo Configuración en la ventana Propiedades y seleccione la propiedad adecuada de la lista.

System_CAPS_noteNota

Cuando se marca una propiedad con el objeto RecommendedAsConfigurableAttribute establecido en true, el valor de este atributo se establece en el miembro constante Yes.En el caso de las propiedades marcadas con RecommendedAsConfigurableAttribute establecido en false, el valor es No.Por 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, vea Extending Metadata Using Attributes.

.

El siguiente ejemplo marca una propiedad para indicar que se puede utilizar 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 RecommendedAsConfigurableAttribute para MyProperty.Primero, el código obtiene PropertyDescriptorCollection con todas las propiedades para el objeto.A continuación, lo indiza en PropertyDescriptorCollection para obtener MyProperty.Posteriormente, devuelve los atributos de esta propiedad y los guarda en la variable de atributos.

En el ejemplo se muestran dos formas diferentes de comprobar el valor del objeto RecommendedAsConfigurableAttribute.En el segundo fragmento de código, se llama al método Equals.En el último fragmento de código, se utiliza la propiedad RecommendedAsConfigurable 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 objeto RecommendedAsConfigurableAttribute, debe utilizarse 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

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar: