LocalFileSettingsProvider.SetPropertyValues Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

LocalFileSettingsProvider.cs

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

ConfigurationErrorsException

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.

Weitere Informationen

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