Compartir a través de

Atributos de configuración de la aplicación

La arquitectura de configuración de aplicaciones proporciona muchos atributos que se pueden aplicar tanto en la clase contenedora de configuración de aplicaciones como en sus propiedades individuales. La infraestructura de configuración de la aplicación examina estos atributos en tiempo de ejecución, a menudo el proveedor de configuración, para adaptar su funcionamiento a las necesidades indicadas del contenedor personalizado.

En la tabla siguiente se enumeran los atributos que se pueden aplicar a la clase contenedora de configuración de la aplicación, las propiedades individuales de esta clase o ambas. Por definición, solo debe aplicarse un único atributo de ámbito —UserScopedSettingAttribute o ApplicationScopedSettingAttribute— a cada propiedad de configuración.

Nota:

Un proveedor de configuración personalizado, derivado de la SettingsProvider clase , solo es necesario para reconocer los tres atributos siguientes: ApplicationScopedSettingAttribute, UserScopedSettingAttribute y DefaultSettingValueAttribute.

Atributo Objetivo Descripción
SettingsProviderAttribute Ambos Especifica el nombre corto del proveedor de configuración que se va a usar para la persistencia.

Si no se proporciona este atributo, se asume el proveedor predeterminado, LocalFileSettingsProvider, .
UserScopedSettingAttribute Ambos Define una propiedad como una configuración de aplicación con ámbito de usuario.
ApplicationScopedSettingAttribute Ambos Define una propiedad como una configuración de aplicación con ámbito de aplicación.
DefaultSettingValueAttribute Propiedad Especifica una cadena que el proveedor puede deserializar en el valor predeterminado codificado de forma rígida para esta propiedad.

LocalFileSettingsProvider no requiere este atributo y invalidará cualquier valor proporcionado por este atributo si ya hay un valor persistente.
SettingsDescriptionAttribute Propiedad Proporciona la prueba descriptiva para una configuración individual, usada principalmente por herramientas en tiempo de ejecución y en tiempo de diseño.
SettingsGroupNameAttribute Clase Proporciona un nombre explícito para un grupo de configuración. Si falta este atributo, ApplicationSettingsBase usa el nombre de la clase contenedora.
SettingsGroupDescriptionAttribute Clase Proporciona la prueba descriptiva para un grupo de configuración, utilizado principalmente por herramientas en tiempo de ejecución y en tiempo de diseño.
SettingsManageabilityAttribute Ambos Especifica cero o más servicios de gestionabilidad que se deben proporcionar al grupo de configuración o propiedad. La enumeración describe los SettingsManageability servicios disponibles.
SpecialSettingAttribute Propiedad Indica que una configuración pertenece a una categoría especial predefinida, como una cadena de conexión, que sugiere un procesamiento especial por parte del proveedor de configuración. Las categorías predefinidas para este atributo se definen mediante la SpecialSetting enumeración .
SettingsSerializeAsAttribute Ambos Especifica un mecanismo de serialización preferido para un grupo o propiedad de configuración. Los mecanismos de serialización disponibles están definidos por la enumeración SettingsSerializeAs.
NoSettingsVersionUpgradeAttribute Propiedad Especifica que un proveedor de configuración debe deshabilitar toda la funcionalidad de actualización de aplicaciones para la propiedad marcada.

La clase indica que el atributo solo se puede aplicar a una clase contenedora de configuración de la aplicación. La propiedad indica que el atributo solo se puede aplicar a las propiedades de configuración. Ambos indican que el atributo se puede aplicar en cualquier nivel.

Consulte también