SettingsProvider Clase

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

SettingsProvider.cs

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::ProviderBase

public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase

type SettingsProvider = class
    inherit ProviderBase

Public MustInherit Class SettingsProvider
Inherits ProviderBase

Herencia

Object

ProviderBase

SettingsProvider

Derivado

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

System.Web.Profile.ProfileProvider

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:

1. Si el proveedor puede cumplir la solicitud implícita por el atributo , obviamente debe hacerlo.

2. Si el proveedor no puede cumplir la solicitud, debe omitirla silenciosamente.

3. 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)

Consulte también

• IApplicationSettingsProvider
• LocalFileSettingsProvider
• SettingsProviderAttribute
• ApplicationSettingsBase
• ConfigurationException
• Arquitectura de configuración de la aplicación
• Atributos de configuración de la aplicación