LocalFileSettingsProvider.SetPropertyValues Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger värdena för den angivna gruppen med egenskapsinställningar.
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)Parametrar
- context
- SettingsContext
En SettingsContext som beskriver den aktuella programanvändningen.
En SettingsPropertyValueCollection som representerar den grupp med egenskapsinställningar som ska anges.
Undantag
En inställning med användaromfattning påträffades, men den aktuella konfigurationen stöder endast programomfattningsinställningar.
-eller-
Det gick inte att spara inställningarna i konfigurationsfilen.
Kommentarer
En inställningsomslutningsklass, härledd från ApplicationSettingsBase, innehåller metoden, som anropas Save för att bevara värdena för alla dess inställningsegenskaper. Den här metoden räknar upp genom alla inställningar som är associerade med dess inställningsegenskaper och anropar SetPropertyValues metoden för var och en SettingsProvider för att utföra den faktiska serialiseringsåtgärden.
SetPropertyValues serialiserar varje egenskap för användaromfattande programinställningar individuellt till motsvarande programinställning i lämplig user.config konfigurationsfil.
Som standard SetPropertyValues använder metoden följande logiska sekvens för att fastställa serialiseringsschemat, beroende på typ av inställningsegenskap:
Om typen har en associerad TypeConverter med en ConvertToString metodimplementering används den här konverteringen.
XML-serialisering används.
Du kan dock ange en önskad serialiseringsmekanism med hjälp SettingsSerializeAsAttributeav . LocalFileSettingsProvider stöder inte binär serialisering i Visual Studio 2005.
Om en egenskap för användaromfångsinställningar uttryckligen anges till standardvärdet tar den lokala filinställningsprovidern bort posten för den associerade inställningen från användarkonfigurationsfilen. Nästa läsåtkomst för den här egenskapen använder helt enkelt standardvärdet.
Caution
LocalFileSettingsProvider använder inte kryptering för att spara några inställningar. Lagra därför inte lösenord för oformaterad text eller annan känslig information med hjälp av den här providern utan att vidta ytterligare försiktighetsåtgärder, till exempel att separat kryptera informationen i konfigurationsfilen. Mer information finns i Kryptera konfigurationsinformation med skyddad konfiguration.