SettingsProvider Classe

  • Referência

Definição

Namespace:
System.Configuration
Assembly:
System.Configuration.ConfigurationManager.dll
Assembly:
System.dll
Pacote:
System.Configuration.ConfigurationManager v6.0.0
Pacote:
System.Configuration.ConfigurationManager v7.0.0
Pacote:
System.Configuration.ConfigurationManager v8.0.0
Pacote:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
Origem:
SettingsProvider.cs
Origem:
SettingsProvider.cs
Origem:
SettingsProvider.cs

Atua como uma classe base para derivação de provedores de configurações personalizados na arquitetura de configurações do aplicativo.

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
Herança
Object
ProviderBase
SettingsProvider
Derivado

Comentários

Um provedor de configurações define o 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. No entanto, você pode criar mecanismos de armazenamento alternativos derivando da classe abstrata SettingsProvider . O provedor que uma classe wrapper usa é determinado decorando a classe wrapper com o SettingsProviderAttribute. Se esse atributo não for fornecido, o padrão, LocalFileSettingsProvider, será usado.

Ao criar um provedor de configurações personalizado, no mínimo, você deve fornecer implementações para os três métodos dessa classe: GetPropertyValues, SetPropertyValues e ApplicationName.

Para aplicativos cliente, você pode adicionar funcionalidades mais padronizadas a um provedor personalizado implementando também a IApplicationSettingsProvider interface . Essa interface espelha métodos encontrados na classe , que habilita principalmente o ApplicationSettingsBase suporte ao controle de versão.

Normalmente, você deve projetar provedores de configurações para serem de instância única para evitar a contenção de recursos de armazenamento. Os provedores também devem ser thread-safe porque podem ser chamados simultaneamente de várias instâncias de wrapper em um único domínio de aplicativo ou de vários aplicativos em domínios diferentes.

No mínimo, um provedor de configurações deve reconhecer três atributos – ApplicationScopedSettingAttribute, UserScopedSettingAttributee DefaultSettingValueAttribute. Para obter uma listagem completa de atributos que podem ser aplicados às configurações do aplicativo, consulte Atributos de Configurações do Aplicativo. Um provedor de configuração personalizado deve resolve atributos aplicados às propriedades de configurações da seguinte maneira:

  1. Se o provedor puder atender à solicitação implícita pelo atributo , obviamente ele deverá fazê-lo.

  2. Se o provedor não puder atender à solicitação, ele deverá ignorá-la silenciosamente.

  3. Se duas ou mais propriedades entrarem em conflito; por exemplo, uma propriedade que está sendo decorada com ApplicationScopedSettingAttribute e UserScopedSettingAttribute; o provedor deve gerar um ConfigurationException.

Construtores

SettingsProvider()

Inicializa uma instância da classe SettingsProvider.

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)
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 construtor de configuração.

(Herdado de ProviderBase)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
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)

Aplica-se a

Confira também