Externe Assemblys
In Skripten und globalen Modulen können externe Assemblys verwendet werden. Es können sowohl Standard- als auch kompilierte Benutzerassemblys verwendet werden.
Hinzufügen externer Assemblys
Auf der Registerkarte Skripts des Dialogfelds Stapeltypeigenschaften oder in Extras → Optionen… können Sie externe Assemblys hinzufügen. Alle Klassen und Methoden der von Ihnen hinzugefügten Assemblys sind in Skripten und globalen Modulen verfügbar.
Assemblys, die Sie zu den Eigenschaften eines Stapeltyps oder einer Dokumentdefinition hinzufügen, stehen nur diesem Stapeltyp bzw. dieser Dokumentdefinition zur Verfügung.
So fügen Sie ein Assembly hinzu:
- Klicken Sie im Dialogfeld Projekteigenschaften auf die Registerkarte Skripte und klicken Sie dann auf die Schaltfläche Referenzen .Net...;
- Im daraufhin angezeigten Dialogfeld klicken Sie auf Hinzufügen...;
- Wählen Sie im Dialogfeld Assembly hinzufügen im Feld Typ Angehängte Datei oder Standardname für Assembly;
- Geben Sie in Abhängigkeit vom gewählten Typ den Pfad zur Datei oder den Standardnamen an.
Nachfolgend finden Sie einen Beispielcode einer Benutzerassembly, die einen Namensraum, eine Klasse und eine Methode dieser Klasse enthält:
namespace TestNameSpace
{
public class Test
{
public void Show(string text)
{
// zeigt eine Textmeldung – statische Methode Show(string text) der Klasse System.Windows.Forms.MessageBox;
System.Windows.Forms.MessageBox.Show(text);
}
}
}
Ein Skript, das Klassen oder Methoden einer externen Assembly verwendet, muss den folgenden Code enthalten:
TestNameSpace.Test test = new TestNameSpace.Test(); // erstellt ein Objekt der Klasse Test
test.Show(“Hello world”); // ruft die Methode Show() der Klasse Test auf
Debugging externer Assemblys
Beim Debugging externer Assemblys sind sowohl die Assemblydatei als auch eine *.pdb-Datei mit symbolischen Informationen erforderlich. Nur Assemblys mit geladenen *.pdb-Dateien können debugged werden. Da die pdb-Dateien eher groß sind, empfiehlt es sich, das Laden von symbolischen Informationen im Arbeitsprojekt zu deaktivieren.
Registrierungsschlüssel, die das Laden von symbolischen Informationen steuern:
Sie können die folgenden Registrierungsschlüssel verwenden, um festzulegen, ob *.pdb-Dateien geladen werden sollen:
- HKEY_CURRENT_USER\Software\ABBYY\ScanStationFC\4.0\Shell\Script [LoadSymbolsFromOriginalPath] - Geben Sie an, ob die *.pdb-Dateien aus demselben Ordner geladen werden, aus dem die Assembly geladen wurden (setzen Sie den Wert des Schlüssels auf True, um *.pdb-Dateien zu laden)
- HKEY_CURRENT_USER\Software\ABBYY\ScanStationFC\4.0\Shell\Script[PDBSearchLocations] = <path to the folder with PDB files> - Gibt die Suchpfade an, unter denen nach *.pdb-Dateien gesucht wird (die Pfade müssen durch Semikolons getrennt werden; das Suchergebnis ist eine *.pdb-Datei mit symbolischen Informationen, wobei der Dateiname identisch mit dem Assemblynamen ist).
Diese Schlüssel werden nicht standardmäßig in der Registrierung erstellt. Der Administrator kann diese Schlüssel gegebenenfalls zur Registry des Betriebssystems auf dem Rechner des Benutzers hinzufügen.
Damit die Änderungen in der Registry übernommen werden, müssen Sie das Programm neu starten.
Für das Debugging einer Assembly muss die Verbindung zum verwalteten Code verwendet werden.
12.04.2024 18:16:01