SettingsProvider Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Actúa como una clase base para derivar los proveedores de configuración personalizados de la arquitectura de configuración de aplicación.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Herencia
- Derivado
Comentarios
Un proveedor de configuración define el mecanismo para almacenar los datos de configuración usados en la arquitectura de configuración de la aplicación. .NET Framework contiene un único proveedor de configuración predeterminado, LocalFileSettingsProvider, que almacena los datos de configuración en el sistema de archivos local. Sin embargo, puede crear mecanismos de almacenamiento alternativos derivando de la clase abstracta SettingsProvider . El proveedor que usa una clase contenedora viene determinado por la decoración de la clase contenedora con SettingsProviderAttribute. Si no se proporciona este atributo, se usa el valor predeterminado, LocalFileSettingsProvider, .
Al crear un proveedor de configuración personalizado, como mínimo, debe proporcionar implementaciones para los tres métodos de esta clase: GetPropertyValues, SetPropertyValues y ApplicationName.
En el caso de las aplicaciones cliente, puede agregar una funcionalidad más estandarizada a un proveedor personalizado mediante la implementación de la IApplicationSettingsProvider interfaz . Este método de interfaz refleja los métodos que se encuentran en la ApplicationSettingsBase clase , lo que permite principalmente la compatibilidad con el control de versiones.
Normalmente, debe diseñar proveedores de configuración para que sean de instancia única para evitar la contención de recursos de almacenamiento. Los proveedores también deben ser seguros para subprocesos porque se pueden llamar simultáneamente desde varias instancias de contenedor en un solo dominio de aplicación o desde varias aplicaciones en dominios diferentes.
Como mínimo, un proveedor de configuración debe reconocer tres atributos: ApplicationScopedSettingAttribute, UserScopedSettingAttributey DefaultSettingValueAttribute. Para obtener una lista completa de los atributos que se pueden aplicar a la configuración de la aplicación, consulte Atributos de configuración de la aplicación. Un proveedor de configuración personalizada debe resolver los atributos aplicados a las propiedades de configuración de la siguiente manera:
Si el proveedor puede cumplir la solicitud implícita por el atributo , obviamente debe hacerlo.
Si el proveedor no puede cumplir la solicitud, debe omitirla silenciosamente.
Si dos o más propiedades entran en conflicto; por ejemplo, una propiedad que se va a decorar con ApplicationScopedSettingAttribute y UserScopedSettingAttribute; el proveedor debe iniciar un ConfigurationException.
Constructores
| SettingsProvider() |
Inicializa una instancia de la clase SettingsProvider. |
Propiedades
| ApplicationName |
Obtiene o establece el nombre de la aplicación que se está ejecutando actualmente. |
| Description |
Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario. (Heredado de ProviderBase) |
| Name |
Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración. (Heredado de ProviderBase) |
Métodos
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Devuelve la colección de valores de propiedades de configuración para la instancia de la aplicación y el grupo de propiedades de configuración especificados. |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Initialize(String, NameValueCollection) |
Inicializa el generador de configuración. (Heredado de ProviderBase) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Establece los valores del grupo especificado de valores de propiedades. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
