LocalFileSettingsProvider.SetPropertyValues Método
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.
Define os valores do grupo especificado de definições de propriedades.
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
A descreve a utilização atual da SettingsContext aplicação.
A SettingsPropertyValueCollection representa o grupo de definições de propriedade a definir.
Exceções
Foi encontrada uma configuração com âmbito de utilizador, mas a configuração atual apenas suporta definições com âmbito de aplicação.
-ou-
Houve uma falha geral ao guardar as definições no ficheiro de configuração.
Observações
Uma classe de wrapper settings, derivada de ApplicationSettingsBase, contém o Save método, que é chamado para persistir os valores de todas as suas propriedades de settings. Este método enumera através de todos os fornecedores de definições associados às suas propriedades de definições, e chama o SetPropertyValues método para cada SettingsProvider um realizar a operação real de serialização.
SetPropertyValues Serializa individualmente cada propriedade de definições de aplicação com âmbito de utilizador para a sua configuração correspondente no ficheiro de configuração apropriado user.config .
Por defeito, o SetPropertyValues método utiliza a seguinte sequência lógica para determinar o esquema de serialização, dependendo do tipo da propriedade de definições:
Se o tipo tiver uma implementação associada TypeConverter a um ConvertToString método, esta conversão é utilizada.
Utiliza-se serialização XML.
No entanto, pode especificar um mecanismo de serialização preferencial usando o SettingsSerializeAsAttribute. LocalFileSettingsProvider não suporta serialização binária em Visual Studio de 2005.
Se uma propriedade de definições com âmbito de utilizador for definida explicitamente para o seu valor predefinido, então o fornecedor local de definições de ficheiro removerá a entrada da definição associada do ficheiro de configuração do utilizador. O próximo acesso de leitura para esta propriedade usará simplesmente o valor predefinido.
Atenção
LocalFileSettingsProvider não utiliza encriptação para persistir quaisquer definições. Por isso, não armazene palavras-passe em texto simples ou outras informações sensíveis através deste fornecedor sem tomar precauções adicionais, como encriptar separadamente a informação dentro do ficheiro de configuração. Para mais informações, veja Encriptação de Informação de Configuração Usando Configuração Protegida.
