Benutzervariablen

Benutzervariablen sind frei definierbare Variablen, die während der Code Generierung abgefragt werden und dann verarbeitet werden. Benutzervariablen können überall in easy code generator Vorlagen verwendet werden.

Sie finden die Benutzervariablen unter <Code Snippet Generator> -> <User Variables>

Auswahl Benutzervariablen

Wählen Sie eines der Benutzervariablen in der Liste aus. Mit einem Doppelklick oder einem Klick auf den linken Knopf, übernehmen Sie diese in Ihre Vorlage. Mit <Add with capital> steuern Sie, ob die Benutzervariable mit anfangendem Grossbuchstaben geschrieben wird.

Mit dem rechten Knopf öffnen Sie das Eingabefenster für die Benutzervariablen.

Benutzervariablen verwalten

Hier können Sie Ihre Benutzervariablen verwalten.

  • ID: Primärschlüssel, wird von easy code generator vergeben
  • Name: die Bezeichnung ihrer Variable
  • Description: eine kurze Beschreibung wofür Ihre Variable benutzt wird.
  • Default Value: ein Standardwert für die Eingabe des Wertes

Beispiel

Wir definieren eine Vorlage mit folgendem Inhalt:

using System;
using System.Data.SqlClient;
using System.Windows.Forms;

namespace {{<<systemvar>><<name=namespace>><<endsystemvar>>}}.classes
{
public partial class {{<<uservar>><<uservarID=4>><<cap=true>><<enduservar>>}}
{

}
}

Als Name der Namespace verwenden wir nicht einen statischen Text sondern die Systemvariable <namespace>. Gleich nach dem Code „public partial class “ fügen wir die Benutzervariable mit dem Namen className ein (siehe Bild <Auswahl Benutzervariablen>) . Die Nummern vor den Variablennamen sind die IDs (Primärschlüssel). Diesen ID finden Sie im Code {{<<uservar>><<uservarID=4>><<cap=true>><<enduservar>>}} wieder zurück. Mit <<cap=true>> geben wir an, dass unabhängig von der Eingabe, die Variable mit einem Grossbuchstaben beginnen soll.

Wenn wir diese Vorlage ausführen, erkennt easy code generator, dass eine Benutzervariable verwendet wird und fragt nun dem Benutzer für die Eingabe dieser Variable:

Eingabe Benutzervariable während Code-Generierung

Als erstes wird der Name der Benutzervariable angezeigt (className) und gleich anschliessend die kurze Beschreibung bzw. der Hinweis für den Benutzer. Im Eingabefeld, falls definiert, wird der Standardwert angezeigt, ansonsten ist das Feld leer. Dort können Sie nun den Wert Ihrer Variablen eingeben, den easy code generator verwenden wird. Falls Sie den Eingabewert zukünftig als Standardwert verwenden möchten, dann kreuzen Sie „Save value as default“ an. Zum fortfahren klicken Sie auf den Speichern Knopf.

Als Resultat erhalten wir folgenden Code:

using System;
using System.Data.SqlClient;
using System.Windows.Forms;

namespace EasyCodeGenerator.classes
{
    public partial class Products
    {
    }
}

Sie sehen, dass easy code generator den Namespace mit EasyCodeGenerator und den Namen der Klasse mit Products ersetzt hat.

Benutzervariablen können Sie überall in den Vorlagen und wie oft Sie wollen, verwenden. Falls eine Benutzervariable mehrmals im Code vorkommt, wird sie nur einmal abgefragt. Auch wenn Sie von einer Vorlage auf eine andere Vorlage verweisen (siehe Kapitel Verweise) in der ebenfalls die gleiche Benutzervariable vorkommt, wird sie nur einmalig abgefragt.

Hinweis: versuchen Sie so wenig möglich Benutzervariablen zu verwenden und wenn möglich, leiten Sie Namen von bereits verwendeten Elementen ab. So machen Sie Ihren Code noch konsistenter und stabiler.