References

Wenn innerhalb eines Namespaces Klassen eines weiteren Namespaces genutzt werden sollen, müssen diese über ein using-Statement eingebunden werden. Dasselbe gilt, wenn Sie externe Klassen nutzen wollen, wie z.B. die des .Net Frameworks.

Über den Dialog References können Sie sowohl interne, als auch externe Referenzen erzeugen.

Wenn Sie als Datentyp für ein Property eine Klasse aus einem anderen Namespace auswählen, wird automatisch ein using für diesen Namespace generiert. Referenzen anlegen / löschen

Um eine Referenz hinzuzufügen, wählen Sie zunächst den Namespace auf der Registerkarte Namespaces aus, dem die Referenz hinzugefügt werden soll. Öffnen Sie anschließend den Dialog References, in dem Sie im unteren Bereich der Registerkarte das Kontext-Menü zu dem Namespace aufrufen und den Eintrag References... aufrufen oder auf den Button button-references.png (References) klicken.

Erzeugen Sie anschließend eine neue Referenz, indem Sie in der Combobox den Bereich auswählen, für den die Referenz erzeugt werden soll und drücken den Button button-new.png (New). Sie sehen die neue Referenz jetzt als Eintrag in der Listbox. Nun werden noch die Einstellungen für die Referenz angepasst, wie nachfolgend beschrieben.

Löschen können Sie eine Referenz, indem Sie in der Combobox den gewünschten Bereich auswählen und anschließend in der Listbox die zu löschende Referenz markieren. Mit dem Button button-delete.png (Delete) wird die Referenz gelöscht.

Wenn ein anderer Namespace innerhalb von Framework Studio referenziert werden soll, wählen Sie als Reference-Type "Framework Studio".

Über die Combobox Namespace haben Sie dann die Möglichkeit den Namespace auszuwählen, der eingebunden werden soll.

Sollten Sie externe Klassen nutzen wollen, geben Sie als Reference-Type External an. Über den Datei-Auswahl-Dialog können Sie anschließend die .Net Assembly auswählen, die Sie einbinden möchten.

references-dialog.png

Referenzen bearbeiten

Name

Hier können Sie die Namen der Referenz angeben. Framework Studio belegt diesen Namen mit ReferenceXX vor.

Combobox Object Type

Object-Type definiert, zu welchem Bereich die Referenz gehört. Da die einzelnen Bereiche eigene Assemblies erzeugen, ist dieser hier ebenfalls zu definieren. Der Standardtyp wird Component sein, da zumeist auf Components referenziert werden wird.

Checkbox Use In Sub Namespaces

Über diese Checkbox können Referenzen an Sub Namespaces vererbt werden.

Die vererbten Referenzen werden in den Sub Namespaces als Derived mit dem Zusatz, aus welchem Namespace die Referenz stammt, dargestellt. Sie können hier nicht bearbeitet werden.

references-dialog-bearbeiten.png

Radion Button Framework Studio Reference

Wählen Sie diesen Radio-Button, wenn Sie eine Framework-Studio-interne Referenz haben wollen.

Namespace

Hier benennen Sie für eine interne Referenz den Namespace, der verwendet werden soll.

Combobox Referenced Object Type

Hier geben Sie für eine interne Referenz an, welcher Bereich eingebunden werden soll.

Es können grundsätzlich alle Object-Types angegeben werden, die vor oder mit dem eigenen Object-Type compiliert werden. Der Wert Component sollte jedoch nur dann verwendet werden, wenn Interface nicht ausreicht. Wenn man im Methoden-Code eine Component aus einem anderen Namespace verwenden möchte, dann wird in der Regel mit deren Interface bzw. der Factory-Klasse gearbeitet. In diesem Fall reicht eine Reference auf Interface völlig aus.

Radio Button External Reference

Wählen Sie diesen Radio-Button, wenn Sie eine externe Assembly einbinden möchten.

Assembly

Hier können Sie ein Assembly angeben, das eingebunden werden soll. Mit dem Button Browse öffnen Sie eine Datei-Auswahl, in der Sie ein Assembly angeben können.

In dieser Zeile können folgende Präfixe verwendet werden:

  • $CodeDirectory: Definiert das Compile-Verzeichnis des Brokers. So können Resources aus dem Ordner bin\ referenziert werden.

    Beispiel: $CodeDirectory\MyOwnAssembly.dll

  • $DotNetDirectory: Definiert das Verzeichnis des .NET Framework 4.8

    Beispiel: $DotNetDirectory\System.Drawing.dll

  • $GAC: Die Assembly soll aus dem Global Assembly Cache geladen werden

    Beispiel: $GAC\ADODB, Version=7.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a

  • $FS: Wird von Framework Studio für Namespace-Referenzen verwendet. Diesen Präfix nicht bei externen Referenzen verwenden.

    Beispiel: $FS\NV.ERP.Base.Customer_C.dll

From GAC

Siehe Referenzen auf GAC-Assemblies

Usings

Hier können Sie angeben, welche Namespaces der eingebundenen Assembly als using verwendet werden sollen. Die Namespaces müssen zeilenweise in das Textfeld geschrieben werden.

Beispiel:

System
System.Collections
System.Text
System.Text.RegularExpressions

Referenzen auf GAC-Assemblies

Es können Assemblies aus dem GAC (Global Assembly Cache) in Framework Studio referenziert werden.

From GAC Button:

references-dialog-gac.png

Nach dem Klick auf den Button erscheint eine Auflistung mit allen Assemblies, die im GAC des aktuellen PC‘s oder Servers vorhanden sind:

GAC-Assembly Auswahldialog:

references-dialog-gac-assembly.png

Wird eine Assembly ausgewählt, erscheint diese mit dem Prefix $GAC und dem starken Namen im References-Dialog:

references-dialog-gac-prefix.png

Wie gewohnt können dann Usings definiert und die Assembly im Code verwendet werden.

Stammt die ausgewählte Assembly aus dem .net Framework, dann wird diese nach der Auswahl automatisch auf $DotNetDirectory umgestellt. Bestehende $GAC-Referenzen können mit der Reference Cleanup Maintenance-Routine gefunden und korrigiert werden.

Caution

Welche GAC-Assemblies auf einem PC oder Server vorhanden sind, ist unterschiedlich und von installierter Software abhängig. Wird eine Framework Studio Applikation auf einem PC oder Server veröffentlicht oder kompiliert, auf dem die referenzierten GAC-Assemblies nicht vorhanden sind, kann es zu Laufzeit- oder Compilierfehlern kommen. Es muss dann sichergestellt werden, dass etwaige Drittsoftware korrekt installiert ist.