Gewusst wie: Erstellen von Anwendungseinstellungen

Aktualisiert: November 2007

Mithilfe von verwaltetem Code können Sie neue Anwendungseinstellungen erstellen und diese an Eigenschaften auf dem Formular oder an Steuerelemente des Formulars binden, sodass diese Einstellungen zur Laufzeit automatisch geladen und gespeichert werden.

In der folgenden Prozedur erstellen Sie manuell eine Wrapperklasse, die sich von ApplicationSettingsBase ableitet. Dieser Klasse fügen Sie eine öffentlich zugreifbare Eigenschaft für jede Anwendungseinstellung hinzu, die Sie verfügbar machen möchten.

Dieses Verfahren können Sie auch im Visual Studio-Designer mit minimalem Programmieraufwand durchführen.

So erstellen Sie programmgesteuert neue Anwendungseinstellungen

1. Fügen Sie dem Projekt eine neue Klasse hinzu, und benennen Sie sie um. In dieser Prozedur nennen wir die Klasse MyUserSettings. Ändern Sie die Klassendefinition, sodass sich die Klasse von ApplicationSettingsBase ableitet.

2. Definieren Sie in dieser Wrapperklasse eine Eigenschaft für jede benötigte Anwendungseinstellung, und wenden Sie diese Eigenschaft entweder mit ApplicationScopedSettingAttribute oder mit UserScopedSettingAttribute an, je nach Bereich der Einstellung. Weitere Informationen zum Einstellungsbereich finden Sie unter Übersicht über Anwendungseinstellungen. Der Code sollte nun wie folgt aussehen:

   Imports System.Configuration
   
   Public Class MyAppSettings
       Inherits ApplicationSettingsBase
       <UserScopedSetting()> _
       <DefaultSettingValue("white")> _
       Public Property BackgroundColor() As Color
           Get
               BackgroundColor = Me("BackgroundColor")
           End Get
   
           Set(ByVal value As Color)
               Me("BackgroundColor") = value
           End Set
       End Property
   End Class
   

   using System;
   using System.Configuration;
   using System.Drawing;
   
   public class MyUserSettings : ApplicationSettingsBase
   {
       [UserScopedSetting()]
       [DefaultSettingValue("white")]
       public Color BackgroundColor
       {
           get
           {
               return ((Color)this["BackgroundColor"]);
           }
           set
           {
               this["BackgroundColor"] = (Color)value;
           }
       }
   }
   

3. Erstellen Sie in der Anwendung eine Instanz dieser Wrapperklasse. Hierbei handelt es sich im Allgemeinen um einen privaten Member des Hauptformulars. Nachdem Sie die Klasse definiert haben, müssen Sie sie an eine Eigenschaft binden, in diesem Fall an die BackColor-Eigenschaft des Formulars. Hierzu können Sie den Load -Ereignishandler des Formulars verwenden.

   Dim Mus As MyAppSettings
   
   Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
       Mus = New MyAppSettings()
       Mus.BackgroundColor = Color.AliceBlue
       Me.DataBindings.Add(New Binding("BackColor", Mus, "BackgroundColor"))
   End Sub
   

   MyUserSettings mus;
   
   private void Form1_Load(object sender, EventArgs e)
   {
       mus = new MyUserSettings();
       mus.BackgroundColor = Color.AliceBlue;
       this.DataBindings.Add(new Binding("BackColor", mus, "BackgroundColor"));
   }
   

4. Wenn Sie eine Möglichkeit bereitstellen, Einstellungen zur Laufzeit zu ändern, müssen Sie die aktuellen Einstellungen des Benutzers auf der Festplatte speichern, wenn Sie das Formular schließen. Andernfalls gehen diese Änderungen verloren.

   Private Sub Form1_FormClosing(ByVal sender As Object, ByVal e As System.Windows.Forms.FormClosingEventArgs) Handles Me.FormClosing
       Mus.Save()
   End Sub
   

   Sie haben nun erfolgreich eine neue Anwendungseinstellung erstellt und sie an die angegebene Eigenschaft gebunden.

Sicherheit

Der standardmäßige Einstellungenanbieter LocalFileSettingsProvider erhält Informationen in Konfigurationsdateien als Nur-Text. Dadurch wird die Sicherheit auf die für den aktuellen Benutzer vom Betriebssystem bereitgestellte Dateizugriffssicherheit beschränkt. Daher sollten die in Konfigurationsdateien gespeicherten Informationen mit Vorsicht verwendet werden. Eine häufige Verwendung von Anwendungseinstellungen besteht zum Beispiel darin, Verbindungszeichenfolgen zu speichern, die auf den Datenspeicher der Anwendung zeigen. Aus Sicherheitsgründen sollten solche Zeichenfolgen jedoch keine Kennwörter enthalten. Weitere Informationen über Verbindungszeichenfolgen finden Sie unter SpecialSetting.

Siehe auch

Aufgaben

Gewusst wie: Überprüfen von Anwendungseinstellungen

Konzepte

Übersicht über Anwendungseinstellungen

Referenz

SpecialSettingAttribute

LocalFileSettingsProvider