Zum Hauptinhalt springen
Externe Assemblies können in Skripten und globalen Modulen verwendet werden. Dabei können sowohl Standard- als auch kompilierte Benutzer-Assemblies verwendet werden.

Externe Assemblies hinzufügen

Sie können Externe Assemblies auf der Registerkarte Skripte im Dialogfeld Batch-Typ-Eigenschaften oder unter Tools → Options… hinzufügen. Alle Klassen und Methoden der Assemblies, die Sie hinzufügen, stehen Skripten und globalen Modulen zur Verfügung. Assemblies, die Sie den Eigenschaften eines Batch-Typs oder einer Document Definition hinzufügen, sind nur für diesen Batch-Typ bzw. diese Document Definition verfügbar. So fügen Sie eine Assembly hinzu:
  1. Öffnen Sie das Dialogfeld Project Properties, klicken Sie auf die Registerkarte Skripte und dann auf die Schaltfläche References .Net…;
  2. Klicken Sie im daraufhin geöffneten Dialogfeld auf Add…;
  3. Wählen Sie im Dialogfeld Add Assembly im Typfeld Attached file oder Standard assembly name aus;
  4. Geben Sie abhängig vom ausgewählten Typ entweder den Pfad zur Datei oder den Standardnamen an.
Nachfolgend finden Sie Beispielcode für eine Benutzer-Assembly, die einen Namespace, eine Klasse und eine Methode dieser Klasse enthält:
namespace TestNameSpace
{
public class Test
    {
    public void Show(string text)
       {
      // zeigt eine Textnachricht an – statische Methode Show(string text) der Klasse System.Windows.Forms.MessageBox;
System.Windows.Forms.MessageBox.Show(text);
       }
    }
}
Ein Skript, das die Klasse und die Methoden einer externen Assembly verwendet, sollte den folgenden Code enthalten:
TestNameSpace.Test test = new TestNameSpace.Test(); // erstellt ein Objekt der Klasse Test
test.Show(“Hello world”); // ruft die void-Methode Show() der Klasse Test auf

Debuggen externer Assemblies

Zum Debuggen externer Assemblies werden sowohl die Assembly-Datei als auch die *.pdb-Datei mit Symbolinformationen benötigt. Nur Assemblies, für die eine *.pdb-Datei geladen wurde, können debuggt werden. Da *.pdb-Dateien recht groß sind, empfehlen wir, das Laden von Symbolinformationen im Arbeitsprojekt zu deaktivieren.

Registrierungsschlüssel, die das Laden symbolischer 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] - Gibt an, ob *.pdb-Dateien aus demselben Ordner geladen werden sollen, aus dem die Assembly geladen wurde (um *.pdb-Dateien zu laden, setzen Sie den Wert des Schlüssels auf True)
  • HKEY_CURRENT_USER\Software\ABBYY\ScanStationFC\4.0\Shell\Script[PDBSearchLocations] = <Pfad zum Ordner mit PDB-Dateien> - Gibt die Suchpfade an, in denen nach *.pdb-Dateien gesucht wird (die Pfade müssen durch Semikolons getrennt sein; als Suchergebnis wird eine *.pdb-Datei mit symbolischen Informationen zurückgegeben, deren Name mit dem Namen der Assembly übereinstimmt).
Diese Schlüssel werden standardmäßig nicht in der Registrierung erstellt. Falls erforderlich, kann der Administrator diese Schlüssel der Registrierung des Betriebssystems des Benutzers hinzufügen. Damit die Änderungen in der Registrierung wirksam werden, müssen Sie das Programm neu starten. Um eine Assembly zu debuggen, müssen Sie eine Verbindung mit dem verwalteten Code herstellen.