LocalFileSettingsProvider Clase

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

LocalFileSettingsProvider.cs

Proporciona persistencia a las clases de configuración de la aplicación.

public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider

public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

type LocalFileSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider

Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider

Herencia

Object

ProviderBase

SettingsProvider

LocalFileSettingsProvider

Implementaciones

IApplicationSettingsProvider

Comentarios

Los proveedores de configuración definen un 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. Una propiedad de configuración de la aplicación o un grupo de propiedades se asocian a un proveedor de configuración específico mediante el uso de SettingsProviderAttribute.

Normalmente, el programa cliente no accede explícitamente a esta clase; en su lugar, la arquitectura de configuración de la aplicación invoca automáticamente el proveedor de configuración adecuado cuando se requieren sus servicios. Por ejemplo, muchos de los miembros de ApplicationSettingsBase delegar su trabajo en el proveedor de configuración asociado.

LocalFileSettingsProvider conserva la configuración de los archivos de configuración que tienen la extensión .config. El contenido de los archivos de configuración se estructura como documentos XML. Dependiendo de si la configuración tiene como ámbito el nivel de aplicación o el nivel de usuario, los datos de configuración se almacenan como elementos dentro de un <applicationSettings><userSettings> grupo de secciones o , respectivamente. Cada uno de estos grupos de secciones se representa mediante un correspondiente AppSettingsSection o ClientSettingsSection, respectivamente. Cada objeto de sección es propiedad de un controlador de sección de configuración, que es un objeto de tipo IConfigurationSectionHandler.

La configuración con ámbito de aplicación y la configuración predeterminada de ámbito de usuario se almacenan en un archivo denominado application.exe.config, que se crea en el mismo directorio que el archivo ejecutable. Las opciones de configuración de la aplicación son de solo lectura. Los datos de usuario específicos se almacenan en un archivo denominado user.config, almacenado en el directorio principal del usuario. Si los perfiles móviles están habilitados, podrían existir dos versiones del archivo de configuración de usuario. En tal caso, las entradas de la versión móvil tienen prioridad sobre las entradas duplicadas en el archivo de configuración de usuario local.

Para obtener más información sobre la configuración de la aplicación, consulte Configuración de la aplicación para Windows Forms.

Constructores

LocalFileSettingsProvider()

Inicializa una nueva instancia de la clase LocalFileSettingsProvider.

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)
GetPreviousVersion(SettingsContext, SettingsProperty)	Devuelve el valor de la propiedad de configuración con nombre para la versión anterior de la misma aplicación.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Devuelve la colección de valores de las 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 proveedor.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Reset(SettingsContext)	Reestablece los valores predeterminados de todas las propiedades de configuración de la aplicación asociadas a la aplicación especificada.
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)
Upgrade(SettingsContext, SettingsPropertyCollection)	Intenta migrar la anterior configuración de ámbito de usuario de una versión anterior de la misma aplicación.

Consulte también

• SettingsProviderAttribute
• ApplicationScopedSettingAttribute
• UserScopedSettingAttribute
• ApplicationSettingsBase
• ClientSettingsSection
• IConfigurationSectionHandler
• Arquitectura de configuración de la aplicación