Exemplarische Vorgehensweise: Speichern und Abrufen von dynamischen Eigenschaften mit Hilfe von Visual J#

  • Artikel

Die Prozeduren in diesem Thema zeigen den Prozess zum Erstellen eines Projekts, zum Speichern einiger Einstellungen von Eigenschaften in einer externen Datei und zum anschließenden Ändern der gespeicherten Werte und deren Aktualisierung in der weitergegebenen Anwendung.

In dieser Anwendung erstellen Sie eine Instanz der EventLog-Komponente und speichern deren Eigenschaftenwerte in einer Datei.

So erstellen Sie die Komponenteninstanz

  1. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  2. Wählen Sie im Dialogfeld Neues Projekt im linken Bereich zunächst Visual J#-Projekte und dann die Vorlage Windows-Anwendung. Nennen Sie sie MyLog.

  3. Ziehen Sie in der Toolbox von der Registerkarte Komponenten eine EventLog-Komponente auf das Formular.

    Hinweis   Dynamische Eigenschaften sind in keiner Weise der EventLog-Komponente zugeordnet; diese Komponente wird hier nur als Beispiel für den Typ von Komponenten verwendet, deren Eigenschaften extern gespeichert werden können.

  4. Legen Sie im Eigenschaftenfenster für die EventLog-Komponente folgende Werte fest:

    • Legen Sie für die Log-Eigenschaft Application fest, so dass die Komponente eine Verbindung zu einem gültigen Windows-Ereignisprotokoll herstellen kann.
    • Legen Sie für die MachineName-Eigenschaft den Namen des Servers fest, auf dem sich das Ereignisprotokoll befindet. Verwenden Sie für den lokalen Computer einen Punkt (.).
    • Legen Sie für die Source-Eigenschaft die Zeichenfolge Ihrer Wahl fest. In diesem Fall können Sie den Namen Ihres Projekts verwenden.

  5. Klicken Sie im Menü Ansicht auf Code, um den Code-Editor für Form1 zu öffnen.

  6. Erweitern Sie den Knoten mit dem Namen Vom Windows-Formular-Designer generierter Code.

    Sie müssten, wie im Folgenden gezeigt, eine Zeile mit dem Eigenschaftenwert für die Log-Eigenschaft sehen:

    // Visual J#
this.eventLog1.set_Log("Application");

  7. Speichern Sie die Dateien.

    Hinweis   Weitere Informationen über das Erstellen von Instanzen der EventLog-Komponente und das Festlegen der Komponenteneigenschaften finden Sie unter Protokollieren von Anwendungs-, Server- und Sicherheitsereignissen.

So zeigen Sie den Wert der Protokolleigenschaft an

  1. Ziehen Sie im Designer eine Bezeichnung und eine Schaltfläche von der Registerkarte Windows Forms der Toolbox in Form1.

  2. Doppelklicken Sie auf die Schaltfläche, um den Code-Editor zu öffnen und auf den Click-Ereignishandler des Button-Steuerelements zuzugreifen.

  3. Fügen Sie diesen Code zur Methode hinzu.

    // Visual J#
label1.set_Text("You are connected to the " + eventLog1.get_Log() + " Log.");

So konfigurieren Sie die Protokolleigenschaft der Komponente

  1. Klicken Sie im Eigenschaftenfenster für die EventLog-Komponente auf das Pluszeichen (+) neben Dynamic Properties.

  2. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten neben der Log-Eigenschaft.

  3. Aktivieren Sie im daraufhin angezeigten Dialogfeld Dynamische Eigenschaft das Kontrollkästchen Eigenschaft zu einem Schlüssel in der Konfigurationsdatei zuordnen, und klicken Sie anschließend auf OK.

    Das bedeutet, dass der Wert der Log-Eigenschaft mit dem Standardschlüssel – dem Klassennamen und dem Eigenschaftennamen – gespeichert wird. In diesem Fall ist der Schlüssel eventLog1.Log.

  4. Öffnen Sie den Code-Editor für Form1, und suchen Sie die InitializeComponent-Prozedur für MyLog.

    Der Code müsste nun automatisch geändert worden sein und angeben, dass der Wert jetzt extern gespeichert ist:

    // Visual J#
this.eventLog1.set_Log(((String)(configurationAppSettings.GetValue(("eventLog1.Log"),
   String.class.ToType()))));
this.eventLog1.set_Source("MyLog");

  5. Speichern Sie die Dateien, und erstellen Sie das Projekt.

  6. Doppelklicken Sie im Projektmappen-Explorer auf die CONFIG-Datei für das Projekt, um sie im Editor anzuzeigen. Sie müssten den Eintrag für den EventLog1.Log-Eigenschaftenwert finden können:

    // Visual J#
<add key="eventLog1.Log" value="Application" />

  7. Führen Sie die Anwendung aus. Wenn Sie auf die Schaltfläche klicken, müssten Sie darüber informiert werden, dass Sie mit dem Anwendungsprotokoll verbunden sind.

  8. Schließen Sie die Anwendung.

Sie haben außerdem die Möglichkeit, die gespeicherten Werte zu ändern, ohne dass die Anwendung ausgeführt wird. Dies ist z. B. dann sinnvoll, wenn Sie die Anfangswerte für eine Anwendung festlegen.

So ändern Sie den gespeicherten Wert der CONFIG-Projektdatei

  1. Öffnen Sie in Notepad die CONFIG-Datei im Projektordner.
  2. Suchen Sie den EventLog1.Log-Eintrag, den Sie sich in der vorhergehenden Prozedur angesehen haben.
  3. Ändern Sie den Wert in dieser Zeile in System oder Security; speichern Sie anschließend die Datei und schließen Sie sie.
  4. Drucken Sie F5, um die Anwendung auszuführen. Wenn Sie auf die Schaltfläche klicken, müsste der neue Wert angegeben werden.

Die im Projektordner enthaltene Konfigurationsdatei hat den Namen App.config. Wenn Sie das Projekt erstellen, wird sie in den Ausgabeordner kopiert und in Assemblyname.config umbenannt, wobei Assemblyname für die Projektausgabe steht, z. B. MyLibrary.dll oder MyApplication.exe. Sie müssen die Kopie der CONFIG-Datei ändern, um eine weitergegebene Anwendung zu beeinflussen. Weitere Informationen finden Sie unter Ändern des Wertes dynamischer Eigenschaften.

So ändern Sie den gespeicherten Wert der weitergegebenen CONFIG-Datei

  1. Öffnen Sie im Notepad die CONFIG-Datei für die Anwendung an ihrem Erstellungsort (oft ist dies der Ordner \bin oder \obj\debug des Projektordners).
  2. Suchen Sie den EventLog1.Log-Eintrag, den Sie sich in der vorhergehenden Prozedur angesehen haben.
  3. Ändern Sie den Wert in dieser Zeile in System oder Security; speichern Sie anschließend die Datei und schließen Sie sie.
  4. Führen Sie die Anwendung an ihrem Erstellungsort aus. Dies ist derselbe Ordner, in dem Sie die CONFIG-Datei in Schritt 1 geändert haben. Wenn Sie auf die Schaltfläche klicken, müsste der neue Wert angegeben werden.

Siehe auch

Einführung in dynamische Eigenschaften | Konfigurieren von Anwendungen mit Hilfe von dynamischen Eigenschaften | Exemplarische Vorgehensweise für dynamische Eigenschaften