SettingsProvider Classe

Definição

Atua como uma classe base para derivação de provedores de configurações personalizados na arquitetura de configurações do aplicativo.Acts as a base class for deriving custom settings providers in the application settings architecture.

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
SettingsProvider
Derivado

Comentários

Um provedor de configurações define o mecanismo para armazenar os dados de configuração usados na arquitetura de configurações do aplicativo.A settings provider defines the mechanism for storing configuration data used in the application settings architecture. O .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 contains a single default settings provider, LocalFileSettingsProvider, which stores configuration data to the local file system. No entanto, você pode criar mecanismos de armazenamento alternativos derivando da classe abstrata SettingsProvider.However, you can create alternate storage mechanisms by deriving from the abstract SettingsProvider class. O provedor usado por uma classe wrapper é determinado decorando a classe wrapper com o SettingsProviderAttribute.The provider that a wrapper class uses is determined by decorating the wrapper class with the SettingsProviderAttribute. Se esse atributo não for fornecido, o padrão, LocalFileSettingsProvider, será usado.If this attribute is not provided, the default, LocalFileSettingsProvider, is used.

Ao criar um provedor de configurações personalizadas, no mínimo, você deve fornecer implementações para os três métodos dessa classe: GetPropertyValues, SetPropertyValues e ApplicationName.When you create a custom settings provider, at minimum, you must provide implementations for the three methods of this class: GetPropertyValues, SetPropertyValues and ApplicationName.

Para aplicativos cliente, você pode adicionar mais funcionalidade padronizada a um provedor personalizado, implementando também a interface IApplicationSettingsProvider.For client applications, you can add more standardized functionality to a custom provider by also implementing the IApplicationSettingsProvider interface. Essa interface espelha os métodos encontrados na classe ApplicationSettingsBase, que habilita principalmente o suporte ao controle de versão.This interface mirrors methods found in the ApplicationSettingsBase class, which mainly enables versioning support.

Normalmente, você deve criar provedores de configurações para serem de instância única para evitar a contenção de recursos de armazenamento.Typically, you should design settings providers to be single-instanced to avoid storage resource contention. 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.Providers should also be thread-safe because they can be called simultaneously from multiple wrapper instances in a single application domain or from multiple applications in different domains.

No mínimo, um provedor de configurações deve reconhecer três atributos – ApplicationScopedSettingAttribute, UserScopedSettingAttributee DefaultSettingValueAttribute.At minimum, a settings provider must recognize three attributes - ApplicationScopedSettingAttribute, UserScopedSettingAttribute, and DefaultSettingValueAttribute. Para obter uma lista completa dos atributos que podem ser aplicados às configurações do aplicativo, consulte atributos de configurações do aplicativo.For a full listing of attributes that can be applied to application settings, see Application Settings Attributes. Um provedor de configuração personalizada deve resolver atributos aplicados às propriedades de configurações da seguinte maneira:A custom setting provider should resolve attributes applied to settings properties in the following manner:

  1. Se o provedor puder atender à solicitação implícita pelo atributo, obviamente ele deverá fazer isso.If the provider can fulfill the request implied by the attribute, obviously it should do so.

  2. Se o provedor não puder atender à solicitação, ele deverá ignorá-lo silenciosamente.If the provider cannot fulfill the request, it should ignore it silently.

  3. Se duas ou mais propriedades entrarem em conflito; por exemplo, uma propriedade que está sendo decorada com ApplicationScopedSettingAttribute e UserScopedSettingAttribute; o provedor deve lançar um ConfigurationException.If two or more properties conflict; for example, a property being decorated with both ApplicationScopedSettingAttribute and UserScopedSettingAttribute; the provider should throw a ConfigurationException.

Construtores

SettingsProvider()

Inicializa uma instância da classe SettingsProvider.Initializes an instance of the SettingsProvider 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)
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 settings 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 construtor de configuração.Initializes the configuration builder.

(Herdado de ProviderBase)
MemberwiseClone()

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

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

Aplica-se a

Veja também