LocalFileSettingsProvider LocalFileSettingsProvider LocalFileSettingsProvider LocalFileSettingsProvider Class

Definición

Proporciona persistencia a las clases de configuración de la aplicación.Provides persistence for application settings classes.

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
LocalFileSettingsProviderLocalFileSettingsProviderLocalFileSettingsProviderLocalFileSettingsProvider
Implementaciones

Comentarios

Los proveedores de configuración definen un mecanismo para almacenar los datos de configuración que se usan en la arquitectura de configuración de la aplicación.Setting providers define a mechanism for storing configuration data used in the application settings architecture. Contiene un proveedor de configuración predeterminado único, LocalFileSettingsProvider, que almacena los datos de configuración en el sistema de archivos local. .NET Framework.NET FrameworkThe .NET Framework.NET Framework contains a single default settings provider, LocalFileSettingsProvider, which stores configuration data to the local file system. Una propiedad o un grupo de propiedades de configuración de la aplicación se asocia a un proveedor de configuración específico SettingsProviderAttributemediante el uso de.An application settings property or group of properties are associated to a specific settings provider through the use of the SettingsProviderAttribute.

Normalmente, el programa cliente no tiene acceso 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.Typically, the client program does not explicitly access this class; rather, the application settings architecture automatically invokes the appropriate settings provider when its services are required. Por ejemplo, muchos de los miembros de ApplicationSettingsBase delegan su trabajo en el proveedor de configuración asociado.For example, many of the members of ApplicationSettingsBase delegate their work to the associated settings provider.

LocalFileSettingsProviderconserva la configuración en los archivos de configuración que tienen .configla extensión.LocalFileSettingsProvider persists settings to configuration files that have the extension .config. El contenido de los archivos de configuración se estructura como documentos XML.The contents of configuration files are structured as XML documents. Dependiendo de si la configuración tiene como ámbito el nivel de aplicación o de usuario, los datos de configuración se almacenan como elementos dentro de un <applicationSettings> grupo de <userSettings> sección o, respectivamente.Depending on whether the setting is scoped at either the application-level or user-level, the configuration data is stored as elements within an <applicationSettings> or a <userSettings> section group, respectively. Cada uno de estos grupos de secciones se representa mediante AppSettingsSection un ClientSettingsSectiono, respectivamente.Each of these section groups is represented by a corresponding AppSettingsSection or ClientSettingsSection, respectively. Cada objeto de sección es propiedad y se administra mediante un controlador de sección de configuración, que es IConfigurationSectionHandlerun objeto de tipo.Each section object is owned and administered by a configuration section handler, which is an object of type IConfigurationSectionHandler.

La configuración de ámbito de aplicación y la configuración de ámbito de usuario predeterminada se almacenan en un application.exe.configarchivo denominado, que se crea en el mismo directorio que el archivo ejecutable.Application-scoped settings and the default user-scoped settings are stored in a file named application.exe.config, which is created in the same directory as the executable file. Los valores de configuración de la aplicación son de solo lectura.Application configuration settings are read-only. Los datos de usuario específicos se almacenan en user.configun archivo denominado, almacenado en el directorio principal del usuario.Specific user data is stored in a file named user.config, stored under the user's home directory. Si los perfiles móviles están habilitados, podrían existir dos versiones del archivo de configuración de usuario.If roaming profiles are enabled, two versions of the user configuration file could exist. En tal caso, las entradas de la versión móvil tienen prioridad sobre las entradas duplicadas en el archivo de configuración del usuario local.In such a case, the entries in the roaming version take precedence over duplicated entries in the local user configuration file.

Para obtener más información sobre la configuración de la aplicación, consulte configuración de la aplicación para Windows Forms.For more information about application settings, see Application Settings for Windows Forms.

Constructores

LocalFileSettingsProvider() LocalFileSettingsProvider() LocalFileSettingsProvider() LocalFileSettingsProvider()

Inicializa una nueva instancia de la clase LocalFileSettingsProvider.Initializes a new instance of the LocalFileSettingsProvider class.

Propiedades

ApplicationName ApplicationName ApplicationName ApplicationName

Obtiene o establece el nombre de la aplicación que se está ejecutando actualmente.Gets or sets the name of the currently running application.

Description Description Description Description

Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
Name Name Name Name

Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty)

Devuelve el valor de la propiedad de configuración con nombre para la versión anterior de la misma aplicación.Returns the value of the named settings property for the previous version of the same application.

GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) 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.Returns the collection of setting property values for the specified application instance and settings property group.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

Inicializa el proveedor.Initializes the provider.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext)

Reestablece los valores predeterminados de todas las propiedades de configuración de la aplicación asociadas a la aplicación especificada.Resets all application settings properties associated with the specified application to their default values.

SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Establece los valores del grupo especificado de valores de propiedades.Sets the values of the specified group of property settings.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection)

Intenta migrar la anterior configuración de ámbito de usuario de una versión anterior de la misma aplicación.Attempts to migrate previous user-scoped settings from a previous version of the same application.

Se aplica a

Consulte también: