LocalFileSettingsProvider.SetPropertyValues Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt die Werte der angegebenen Gruppe von Eigenschafteneinstellungen fest.
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)Parameter
- context
- SettingsContext
Eine SettingsContext Beschreibung der aktuellen Anwendungsverwendung.
A SettingsPropertyValueCollection representing the group of property settings to set.
Ausnahmen
Es wurde eine Einstellung mit Benutzerbereich gefunden, die aktuelle Konfiguration unterstützt jedoch nur anwendungsbezogene Einstellungen.
- oder -
Beim Speichern der Einstellungen in der Konfigurationsdatei ist ein allgemeiner Fehler aufgetreten.
Hinweise
Eine von dieser abgeleitete ApplicationSettingsBaseEinstellungswrapperklasse enthält die Save Methode, die aufgerufen wird, um die Werte aller zugehörigen Einstellungseigenschaften beizubehalten. Diese Methode listet alle Einstellungsanbieter auf, die ihren Einstellungseigenschaften zugeordnet sind, und ruft die SetPropertyValues Methode für jeden SettingsProvider auf, um den tatsächlichen Serialisierungsvorgang auszuführen.
SetPropertyValues serialisiert jede Anwendungseinstellungseigenschaft auf Benutzerebene einzeln in die entsprechende Anwendungseinstellung in der entsprechenden user.config Konfigurationsdatei.
Standardmäßig verwendet die SetPropertyValues Methode die folgende logische Sequenz, um das Serialisierungsschema abhängig vom Typ der Einstellungseigenschaft zu bestimmen:
Wenn der Typ einer ConvertToString Methodenimplementierung zugeordnet TypeConverter ist, wird diese Konvertierung verwendet.
Die XML-Serialisierung wird verwendet.
Sie können jedoch einen bevorzugten Serialisierungsmechanismus angeben, indem Sie die SettingsSerializeAsAttribute. LocalFileSettingsProvider unterstützt keine binäre Serialisierung in Visual Studio 2005.
Wenn eine Einstellungseigenschaft mit Benutzerbereich explizit auf den Standardwert zurückgesetzt wird, entfernt der anbieter für lokale Dateieinstellungen den Eintrag für die zugeordnete Einstellung aus der Benutzerkonfigurationsdatei. Der nächste Lesezugriff für diese Eigenschaft verwendet einfach den Standardwert.
Vorsicht
LocalFileSettingsProvider verwendet keine Verschlüsselung, um Einstellungen beizubehalten. Speichern Sie daher keine Nur-Text-Kennwörter oder andere vertrauliche Informationen mithilfe dieses Anbieters, ohne zusätzliche Vorkehrungen zu treffen, z. B. die separat verschlüsselten Informationen in der Konfigurationsdatei.
