Atributos de configuración de la aplicación
La arquitectura de la configuración de la aplicación proporciona atributos que se pueden aplicar a la clase contenedora de la configuración de las aplicaciones o a sus propiedades individuales. La arquitectura de la configuración de la aplicación examina estos atributos en tiempo de ejecución, a menudo específicamente el proveedor de configuración, para ajustar su funcionamiento a las necesidades definidas de la clase contenedora personalizada.
La tabla siguiente muestra los atributos que se pueden aplicar a la clase contenedora de la configuración de la aplicación, a las propiedades individuales de esta clase o a ambas. Por definición, sólo un atributo de ámbito único, UserScopedSettingAttribute o ApplicationScopedSettingAttribute, se debe aplicar a cada una de las propiedades de configuración.
Nota
Un proveedor de configuración personalizado, derivado de la clase SettingsProvider, sólo se necesita para reconocer los tres atributos siguientes: ApplicationScopedSettingAttribute, UserScopedSettingAttribute y DefaultSettingValueAttribute.
Atributo |
Destino |
Descripción |
|---|---|---|
Ambos |
Especifica el nombre corto del proveedor de configuración que se va a utilizar para persistencia. Si no se proporciona este atributo, el proveedor predeterminado se supone que es LocalFileSettingsProvider. |
|
Ambos |
Define una propiedad como configuración de la aplicación de ámbito de usuario. |
|
Ambos |
Define una propiedad como configuración de la aplicación de ámbito de aplicación. |
|
Propiedad |
Especifica una cadena que se puede deserializar por el proveedor en el valor predeterminado asignado para esta propiedad. LocalFileSettingsProvider no necesita este atributo y reemplazará cualquier valor proporcionado por este atributo si ya existe un valor guardado. |
|
Propiedad |
Proporciona la comprobación descriptiva para una configuración individual, utilizada principalmente por herramientas en tiempo de ejecución y en tiempo de diseño. |
|
Clase |
Proporciona un nombre explícito para un grupo de valores de configuración. Si falta este atributo, ApplicationSettingsBase utiliza el nombre de la clase contenedora. |
|
Clase |
Proporciona la comprobación descriptiva para una configuración de grupo, utilizada principalmente por herramientas en tiempo de ejecución y en tiempo de diseño. |
|
Ambos |
Especifica cero o más servicios de facilidad de administración que se deberían proporcionar a la propiedad o al grupo de valores de configuración. La enumeración SettingsManageability describe los servicios disponibles. |
|
Propiedad |
Indica que una configuración pertenece a una categoría especial predefinida, como una cadena de conexión que sugiere que el proveedor de configuración aplique un procesamiento especial. La enumeración SpecialSetting define las categorías predefinidas para este atributo. |
|
Ambos |
Especifica un mecanismo de serialización preferido para una propiedad o un grupo de valores de configuración. La enumeración SettingsSerializeAs define los mecanismos de serialización disponibles. |
|
Propiedad |
Especifica que un proveedor de valores de configuración debería deshabilitar la funcionalidad de actualización de la aplicación para la propiedad marcada. |
Clase indica que el atributo sólo se puede aplicar a una clase contenedora de la configuración de la aplicación. Propiedad indica que el atributo se puede aplicar sólo a propiedades de configuración. Ambos indica que el atributo se puede aplicar en cualquier nivel.
Vea también
Tareas
Cómo: Crear una configuración de aplicación mediante el diseñador