LocalFileSettingsProvider.SetPropertyValues Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

LocalFileSettingsProvider.cs

Define os valores do grupo especificado de configurações de propriedade.

public:
 override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);

public override void SetPropertyValues (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);

override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

Parâmetros

context

SettingsContext

Um SettingsContext que descreve o uso do aplicativo atual.

values

SettingsPropertyValueCollection

Um SettingsPropertyValueCollection que representa o grupo de configurações de propriedade a ser definido.

Exceções

ConfigurationErrorsException

Foi encontrada uma configuração de escopo do usuário, mas a configuração atual dá suporte apenas a configurações de escopo do aplicativo.

- ou -

Houve uma falha geral ao salvar as configurações para o arquivo de configuração.

Comentários

Uma classe wrapper de configurações, derivada de ApplicationSettingsBase, contém o Save método , que é chamado para persistir os valores de todas as suas propriedades de configurações. Esse método enumera todos os provedores de configurações associados às suas propriedades de configurações e chama o SetPropertyValues método para cada SettingsProvider um executar a operação de serialização real.

SetPropertyValues serializa individualmente cada propriedade de configurações de aplicativo no escopo do usuário para sua configuração de aplicativo correspondente no arquivo de configuração apropriado user.config .

Por padrão, o SetPropertyValues método usa a seguinte sequência lógica para determinar o esquema de serialização, dependendo do tipo da propriedade settings:

1. Se o tipo tiver um associado a TypeConverter uma ConvertToString implementação de método, essa conversão será usada.

2. A serialização XML é usada.

No entanto, você pode especificar um mecanismo de serialização preferencial usando o SettingsSerializeAsAttribute. LocalFileSettingsProvider não dá suporte à serialização binária no Visual Studio 2005.

Se uma propriedade de configurações no escopo do usuário for definida de volta para seu valor padrão explicitamente, o provedor local de configurações de arquivo removerá a entrada para a configuração associada do arquivo de configuração do usuário. O próximo acesso de leitura para essa propriedade simplesmente usará o valor padrão.

Cuidado

LocalFileSettingsProvider não usa criptografia para persistir as configurações. Portanto, não armazene senhas de texto sem formatação ou outras informações confidenciais usando esse provedor sem tomar precauções adicionais, como criptografar separadamente as informações dentro do arquivo de configuração. Para obter mais informações, consulte Criptografando informações de configuração usando a configuração protegida.

Confira também

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute