LocalFileSettingsProvider.SetPropertyValues Método

Definição

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

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 por meio de 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 de configurações de arquivo local 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 nenhuma configuração. 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.

Aplica-se a

Confira também