LocalFileSettingsProvider Classe

Definição

Fornece a persistência para as classes de configurações do aplicativo.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
Herança
LocalFileSettingsProvider
Implementações

Comentários

A configuração de provedores define um mecanismo para armazenar os dados de configuração usados na arquitetura de configurações do aplicativo.Setting providers define a mechanism for storing configuration data used in the application settings architecture. O .NET Framework.NET Framework contém um único provedor de configurações padrão, LocalFileSettingsProvider, que armazena os dados de configuração para o sistema de arquivos local.The .NET Framework.NET Framework contains a single default settings provider, LocalFileSettingsProvider, which stores configuration data to the local file system. Uma propriedade de configurações de aplicativo ou grupo de propriedades está associado a um provedor de configurações específico por meio do uso do SettingsProviderAttribute.An application settings property or group of properties are associated to a specific settings provider through the use of the SettingsProviderAttribute.

Normalmente, o programa cliente não acessa explicitamente essa classe; em vez disso, a arquitetura de configurações do aplicativo invoca automaticamente o provedor de configurações apropriado quando seus serviços são necessários.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 exemplo, muitos dos membros de ApplicationSettingsBase delegam seu trabalho para o provedor de configurações associado.For example, many of the members of ApplicationSettingsBase delegate their work to the associated settings provider.

LocalFileSettingsProvider mantém as configurações dos arquivos de configuração que têm a extensão .config.LocalFileSettingsProvider persists settings to configuration files that have the extension .config. O conteúdo dos arquivos de configuração é estruturado como documentos XML.The contents of configuration files are structured as XML documents. Dependendo se a configuração tem como escopo o nível do aplicativo ou do usuário, os dados de configuração são armazenados como elementos dentro de um <applicationSettings> ou um <userSettings> grupo de seções, 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 um desses grupos de seções é representado por um AppSettingsSection ou ClientSettingsSectioncorrespondente, respectivamente.Each of these section groups is represented by a corresponding AppSettingsSection or ClientSettingsSection, respectively. Cada objeto de seção é de propriedade e administrado por um manipulador de seção de configuração, que é um objeto do tipo IConfigurationSectionHandler.Each section object is owned and administered by a configuration section handler, which is an object of type IConfigurationSectionHandler.

As configurações no escopo do aplicativo e as configurações padrão no escopo do usuário são armazenadas em um arquivo chamado application.exe.config, que é criado no mesmo diretório que o arquivo executável.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. As definições de configuração do aplicativo são somente leitura.Application configuration settings are read-only. Os dados específicos do usuário são armazenados em um arquivo chamado user.config, armazenado no diretório base do usuário.Specific user data is stored in a file named user.config, stored under the user's home directory. Se os perfis móveis estiverem habilitados, duas versões do arquivo de configuração do usuário poderão existir.If roaming profiles are enabled, two versions of the user configuration file could exist. Nesse caso, as entradas na versão de roaming têm precedência sobre entradas duplicadas no arquivo de configuração de usuário local.In such a case, the entries in the roaming version take precedence over duplicated entries in the local user configuration file.

Para obter mais informações sobre as configurações do aplicativo, consulte configurações do aplicativo para Windows Forms.For more information about application settings, see Application Settings for Windows Forms.

Construtores

LocalFileSettingsProvider()

Inicia uma nova instância da classe LocalFileSettingsProvider.Initializes a new instance of the LocalFileSettingsProvider class.

Propriedades

ApplicationName

Obtém ou define o nome do aplicativo em execução no momento.Gets or sets the name of the currently running application.

Description

Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Herdado de ProviderBase)
Name

Obtém o nome amigável usado para referir-se ao provedor durante a configuração.Gets the friendly name used to refer to the provider during configuration.

(Herdado de ProviderBase)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetPreviousVersion(SettingsContext, SettingsProperty)

Retorna o valor da propriedade de configuração nomeada para a versão anterior do mesmo aplicativo.Returns the value of the named settings property for the previous version of the same application.

GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Retorna a coleção de valores da propriedade de configurações para a instância do aplicativo e o grupo de propriedades de configurações especificados.Returns the collection of setting property values for the specified application instance and settings property group.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
Initialize(String, NameValueCollection)

Inicializa o provedor.Initializes the provider.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Reset(SettingsContext)

Redefine todas as propriedades de configuração do aplicativo associadas ao aplicativo especificado para seus valores padrão.Resets all application settings properties associated with the specified application to their default values.

SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Define os valores do grupo especificado de configurações de propriedade.Sets the values of the specified group of property settings.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
Upgrade(SettingsContext, SettingsPropertyCollection)

Tenta migrar configurações de escopo do usuário anteriores de uma versão anterior do mesmo aplicativo.Attempts to migrate previous user-scoped settings from a previous version of the same application.

Aplica-se a

Veja também