SettingsProvider Classe

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

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

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

System.Web.Profile.ProfileProvider

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)

Confira também

• IApplicationSettingsProvider
• LocalFileSettingsProvider
• SettingsProviderAttribute
• ApplicationSettingsBase
• ConfigurationException
• Arquitetura das configurações do aplicativo
• Atributos de configurações do aplicativo