LocalFileSettingsProvider.SetPropertyValues Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)Parametri
- context
- SettingsContext
Oggetto SettingsContext che descrive l'utilizzo corrente dell'applicazione.
Oggetto SettingsPropertyValueCollection che rappresenta il gruppo di impostazioni delle proprietà da impostare.
Eccezioni
È stata rilevata un'impostazione con ambito utente, ma la configurazione corrente supporta solo le impostazioni con ambito applicazione.
oppure
Si è verificato un errore generale durante il salvataggio delle impostazioni nel file di configurazione.
Commenti
Una classe wrapper delle impostazioni, derivata da ApplicationSettingsBase, contiene il Save metodo , 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à settings:
Se il tipo ha un oggetto associato a TypeConverter un'implementazione ConvertToString del metodo, viene utilizzata questa conversione.
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 delle impostazioni del file locale 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 crittografare separatamente le informazioni all'interno del file di configurazione.
