LocalFileSettingsProvider Classe

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

LocalFileSettingsProvider.cs

Fornece a persistência para as classes de configurações do aplicativo.

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

Object

ProviderBase

SettingsProvider

LocalFileSettingsProvider

Implementações

IApplicationSettingsProvider

Comentários

Os provedores de configuração definem um mecanismo para armazenar dados de configuração usados na arquitetura de configurações do aplicativo. O .NET Framework contém um único provedor de configurações padrão, LocalFileSettingsProvider, que armazena dados de configuração no sistema de arquivos local. Uma propriedade de configurações de aplicativo ou um grupo de propriedades são associados a um provedor de configurações específico por meio do uso do 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. Por exemplo, muitos dos membros do ApplicationSettingsBase delegam seu trabalho para o provedor de configurações associado.

LocalFileSettingsProvider persiste as configurações para arquivos de configuração que têm a extensão .config. O conteúdo dos arquivos de configuração é estruturado como documentos XML. Dependendo se a configuração tem escopo no nível do aplicativo ou no nível do usuário, os dados de configuração são armazenados como elementos dentro de um <applicationSettings> ou de um <userSettings> grupo de seções, respectivamente. Cada um desses grupos de seções é representado por um correspondente AppSettingsSection ou ClientSettingsSection, respectivamente. Cada objeto de seção pertence e é administrado por um manipulador de seção de configuração, que é um objeto do tipo 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. As definições de configuração do aplicativo são somente leitura. Dados de usuário específicos são armazenados em um arquivo chamado user.config, armazenados no diretório base do usuário. Se os perfis móveis estiverem habilitados, poderão existir duas versões do arquivo de configuração do usuário. Nesse caso, as entradas na versão de roaming têm precedência sobre entradas duplicadas no arquivo de configuração do usuário local.

Para obter mais informações sobre as configurações do aplicativo, consulte Configurações do aplicativo para Windows Forms.

Construtores

LocalFileSettingsProvider()

Inicializa uma nova instância da classe LocalFileSettingsProvider.

Propriedades

ApplicationName	Obtém ou define o nome do aplicativo em execução no momento.
Description	Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário). (Herdado de ProviderBase)
Name	Obtém o nome amigável usado para referir-se ao provedor durante a configuração. (Herdado de ProviderBase)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPreviousVersion(SettingsContext, SettingsProperty)	Retorna o valor da propriedade de configuração nomeada para a versão anterior do mesmo aplicativo.
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.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Initialize(String, NameValueCollection)	Inicializa o provedor.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Reset(SettingsContext)	Redefine todas as propriedades de configuração do aplicativo associadas ao aplicativo especificado para seus valores padrão.
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Define os valores do grupo especificado de configurações de propriedade.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	Tenta migrar configurações de escopo do usuário anteriores de uma versão anterior do mesmo aplicativo.

Confira também

• SettingsProviderAttribute
• ApplicationScopedSettingAttribute
• UserScopedSettingAttribute
• ApplicationSettingsBase
• ClientSettingsSection
• IConfigurationSectionHandler
• Arquitetura das configurações do aplicativo