SettingsProvider Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Funciona como uma classe base para derivar fornecedores de definições personalizadas na arquitetura de definições da aplicação.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Herança
- Derivado
Observações
Um fornecedor de definições define o mecanismo para armazenar dados de configuração usados na arquitetura de definições da aplicação. .NET Framework contém um único fornecedor de definições predefinido, LocalFileSettingsProvider, que armazena dados de configuração no sistema de ficheiros local. No entanto, pode criar mecanismos de armazenamento alternativos derivando da classe abstrata SettingsProvider . O fornecedor que uma classe de invólucro utiliza é determinado decorando a classe de invólucro com o SettingsProviderAttribute. Se este atributo não for fornecido, o padrão, LocalFileSettingsProvider, é usado.
Quando cria um fornecedor de definições personalizadas, no mínimo, deve fornecer implementações para os três métodos desta classe: GetPropertyValues, SetPropertyValues e ApplicationName.
Para aplicações cliente, pode adicionar mais funcionalidades padronizadas a um fornecedor personalizado implementando também a IApplicationSettingsProvider interface. Esta interface espelha métodos encontrados na ApplicationSettingsBase classe, que principalmente permitem suporte para versionamento.
Normalmente, deve desenhar fornecedores de definições para serem de instância única para evitar a contenção de recursos de armazenamento. Os fornecedores também devem ser seguros para threads porque podem ser chamados simultaneamente a partir de múltiplas instâncias de wrapper num único domínio de aplicação ou de múltiplas aplicações em domínios diferentes.
No mínimo, um fornecedor de definições deve reconhecer três atributos - ApplicationScopedSettingAttribute, UserScopedSettingAttribute, e DefaultSettingValueAttribute. Para uma lista completa dos atributos que podem ser aplicados às definições da aplicação, consulte Atributos de Definições da Aplicação. Um fornecedor de definições personalizadas deve resolver atributos aplicados às propriedades das definições da seguinte forma:
Se o prestador conseguir satisfazer o pedido implícito pelo atributo, obviamente deve fazê-lo.
Se o fornecedor não conseguir satisfazer o pedido, deve ignorá-lo silenciosamente.
Se duas ou mais propriedades entram em conflito; por exemplo, uma propriedade decorada com e ApplicationScopedSettingAttributeUserScopedSettingAttribute; o fornecedor deve lançar um ConfigurationException.
Construtores
| Name | Description |
|---|---|
| SettingsProvider() |
Inicializa uma instância da SettingsProvider classe. |
Propriedades
| Name | Description |
|---|---|
| ApplicationName |
Recebe ou define o nome da aplicação em curso. |
| Description |
Recebe uma descrição breve e amigável, adequada para exibição em ferramentas administrativas ou outras interfaces de utilizador (UIs). (Herdado de ProviderBase) |
| Name |
Recebe o nome amigável usado para se referir ao fornecedor durante a configuração. (Herdado de ProviderBase) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Devolve a coleção de valores de propriedades de definições para a instância de aplicação especificada e o grupo de propriedades de definições. |
| 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 atual Object. (Herdado de Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Define os valores do grupo especificado de definições de propriedades. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |