LocalFileSettingsProvider.SetPropertyValues Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

LocalFileSettingsProvider.cs

Imposta i valori del gruppo specificato di impostazioni delle proprietà.

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)

Parametri

context

SettingsContext

Oggetto SettingsContext che descrive l'utilizzo dell'applicazione corrente.

values

SettingsPropertyValueCollection

Classe SettingsPropertyValueCollection rappresentante il gruppo di impostazioni delle proprietà da impostare.

Eccezioni

ConfigurationErrorsException

È stata rilevata un'impostazione con ambito di utente, ma la configurazione corrente supporta solo le impostazioni con ambito di applicazione.

-oppure-

Si è verificato un errore generale di salvataggio delle impostazioni nel file di configurazione.

Commenti

Una classe wrapper delle impostazioni, derivata da ApplicationSettingsBase, contiene il Save metodo , che viene chiamato per rendere persistenti i valori di tutte le relative proprietà delle impostazioni. Questo metodo enumera tutti i provider di impostazioni associati alle relative proprietà delle impostazioni e chiama il SetPropertyValues metodo per ognuno SettingsProvider per eseguire l'operazione di serializzazione effettiva.

SetPropertyValues serializza singolarmente ogni proprietà delle impostazioni dell'applicazione con ambito utente nell'impostazione dell'applicazione corrispondente nel file di configurazione appropriato user.config .

Per impostazione predefinita, il SetPropertyValues metodo usa la sequenza logica seguente per determinare lo schema di serializzazione, a seconda del tipo della proprietà delle impostazioni:

1. Se al tipo è associato un oggetto a TypeConverter un'implementazione ConvertToString del metodo, viene utilizzata questa conversione.

2. Viene utilizzata la serializzazione XML.

È tuttavia possibile specificare un meccanismo di serializzazione preferito usando .SettingsSerializeAsAttribute LocalFileSettingsProvider non supporta la serializzazione binaria in Visual Studio 2005.

Se una proprietà delle impostazioni con ambito utente viene impostata nuovamente sul valore predefinito in modo esplicito, il provider di impostazioni file locali rimuoverà la voce per l'impostazione associata dal file di configurazione utente. L'accesso in lettura successivo per questa proprietà userà semplicemente il valore predefinito.

Attenzione

LocalFileSettingsProvider non usa la crittografia per rendere persistenti le impostazioni. Pertanto, non archiviare password di testo normale o altre informazioni riservate usando questo provider senza adottare precauzioni aggiuntive, ad esempio crittografando separatamente le informazioni all'interno del file di configurazione. Per altre informazioni, vedere Crittografia delle informazioni di configurazione tramite la configurazione protetta.

Vedi anche

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