LocalFileSettingsProvider.SetPropertyValues Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define os valores do grupo de configurações de propriedade especificado.
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 -> unitPublic Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)Parâmetros
- context
- SettingsContext
Uma SettingsContext descrição do uso atual do aplicativo.
Um SettingsPropertyValueCollection que representa o grupo de configurações de propriedade a ser definido.
Exceções
Uma configuração no escopo do usuário foi encontrada, mas a configuração atual dá suporte apenas a configurações com escopo de aplicativo.
- ou -
Houve uma falha geral ao salvar as configurações no 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 com escopo de 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 de configurações:
Se o tipo tiver uma implementação associada a TypeConverter um ConvertToString método, essa conversão será usada.
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 com escopo de usuário for definida de volta para seu valor padrão explicitamente, o provedor de configurações de arquivo local removerá a entrada da 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.
