Freigeben über


LocalFileSettingsProvider.SetPropertyValues Methode

Definition

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 -> unit
Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

Parameter

context
SettingsContext

Ein SettingsContext, der die aktuelle Anwendungsverwendung beschreibt.

values
SettingsPropertyValueCollection

Eine SettingsPropertyValueCollection, die die Gruppe der festzulegenden Eigenschafteneinstellungen darstellt.

Ausnahmen

Eine die Benutzer betreffende Einstellung wurde gefunden, die aktuelle Konfiguration unterstützt aber nur die Anwendung betreffende Einstellungen.

- oder -

Beim Speichern der Einstellungen in der Konfigurationsdatei ist ein allgemeiner Fehler aufgetreten.

Hinweise

Eine Einstellungswrapperklasse, die von ApplicationSettingsBaseabgeleitet wird, enthält die Save -Methode, die aufgerufen wird, um die Werte aller einstellungen Eigenschaften beizubehalten. Diese Methode listet alle Einstellungsanbieter auf, die ihren Einstellungseigenschaften zugeordnet sind, und ruft die SetPropertyValues -Methode für jeden SettingsProvider auf, um den eigentlichen Serialisierungsvorgang auszuführen.

SetPropertyValues Serialisiert jede benutzerbezogene Anwendungseinstellungseigenschaft 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:

  1. Wenn der Typ einer ConvertToString Methodenimplementierung zugeordnet TypeConverter ist, wird diese Konvertierung verwendet.

  2. Die XML-Serialisierung wird verwendet.

Sie können jedoch mithilfe von SettingsSerializeAsAttributeeinen bevorzugten Serialisierungsmechanismus angeben. LocalFileSettingsProvider unterstützt keine binäre Serialisierung in Visual Studio 2005.

Wenn eine eigenschaft mit benutzerbezogenen Einstellungen explizit auf ihren Standardwert zurückgesetzt wird, entfernt der Lokale Dateieinstellungsanbieter den Eintrag für die zugeordnete Einstellung aus der Benutzerkonfigurationsdatei. Der nächste Lesezugriff für diese Eigenschaft verwendet einfach den Standardwert.

Achtung

LocalFileSettingsProvider verwendet keine Verschlüsselung, um Einstellungen beizubehalten. Speichern Sie daher mithilfe dieses Anbieters keine Nur-Text-Kennwörter oder andere vertrauliche Informationen, ohne zusätzliche Vorsichtsmaßnahmen zu treffen, z. B. die separate Verschlüsselung der Informationen in der Konfigurationsdatei. Weitere Informationen finden Sie unter Verschlüsseln von Konfigurationsinformationen mithilfe der geschützten Konfiguration.

Gilt für:

Weitere Informationen