Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

RecommendedAsConfigurableAttribute (Clase)

Nota: esta API ya está obsoleta. La alternativa no obsoleta es SettingsBindableAttribute.

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

System.Object
  System.Attribute
    System.ComponentModel.RecommendedAsConfigurableAttribute

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

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

El tipo RecommendedAsConfigurableAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoRecommendedAsConfigurableAttributeInicializa una nueva instancia de la clase RecommendedAsConfigurableAttribute.
Arriba

  NombreDescripción
Propiedad públicaRecommendedAsConfigurableObtiene un valor que indica si la propiedad a la que está enlazado este atributo se puede utilizar como configuración de la aplicación.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Arriba

  NombreDescripción
Método públicoEqualsIndica si esta instancia y un objeto especificado son iguales. (Invalida a Attribute.Equals(Object)).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetHashCodeDevuelve el código hash de esta instancia. (Invalida a Attribute.GetHashCode()).
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoIsDefaultAttributeIndica si el valor de esta instancia es el valor predeterminado de la clase. (Invalida a Attribute.IsDefaultAttribute()).
Método públicoMatch Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Se hereda de Attribute).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Campo públicoMiembro estáticoDefaultEspecifica el valor predeterminado de RecommendedAsConfigurableAttribute, que es No. Este campo static es de solo lectura.
Campo públicoMiembro estáticoNoEspecifica que no se puede utilizar una propiedad como configuración de la aplicación. Este campo static es de solo lectura.
Campo públicoMiembro estáticoYesEspecifica que una propiedad puede utilizarse como configuración de la aplicación. Este campo static es de solo lectura.
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

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

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Arriba

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.

NotaNota

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 Extender metadatos mediante atributos.

.

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

Compatible con: 1.1, 1.0
Obsoleto (advertencia del compilador) en 4.5
Obsoleto (advertencia del compilador) en 4
Obsoleto (advertencia del compilador) en 3.5
Obsoleto (advertencia del compilador) en 3.5 SP1
Obsoleto (advertencia del compilador) en 3.0
Obsoleto (advertencia del compilador) en 3.0 SP1
Obsoleto (advertencia del compilador) en 3.0 SP2
Obsoleto (advertencia del compilador) en 2.0
Obsoleto (advertencia del compilador) en 2.0 SP1
Obsoleto (advertencia del compilador) en 2.0 SP2

.NET Framework Client Profile

Obsoleto (advertencia del compilador) en 4
Obsoleto (advertencia del compilador) en 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft