Der Ablauf in diesem Abschnitt ist nicht zwingend erforderlich. Scripte funktionieren auch wenn sie nur den .NET Runtime installiert haben.
Haben Sie aber auch eine vollständige Microsoft CSharp Entwicklungsumgebung, so können Sie Scripte auch in dieser Umgebung entwickeln und testen.
Um Scripte im Developer Studio debuggen zu können, benötigen Sie das Microsoft Developer Studio, z.B. die kostenfrei erhältliche Version CSharp Express.
Vorgehensweise:
Legen Sie ein neues Developer-Studio Projekt an.
Wählen Sie als Projekttyp "Klassenbibliothek".
In den Einstellungen des Projektes, wählen Sie auf dem Reiter "Debuggen" die Checkbox "Externes Programm starten".
Geben Sie als Namen des externen Programms "s:\vacos\bin\debug05.xxx\SOGFormProjEdit.exe" an.
=> Setzen Sie hier den Namen ihres Projektes und des aktuellen Debug05-Verzeichnisses ein. Den Namen des aktuellen Debug05-Verzeichnisses können Sie der Datei "hhuse05.txt" im Root-Verzeichnis des Projektes entnehmen.
Unter Befehlszeilenargumente tragen Sie ein: -debug {DateinameDerSogFormsDatei}
Beispiel: -debug s:\vacos\sogforms\f003\t1.sogform
Setzen Sie das Arbeitsverzeichnis auf das Root-Verzeichnis des Projektes. z.B: s:\vacos
Öffnen Sie die Script-Datei, und setzen Sie einen Break-Point.
Führen Sie das Programm nun über z.B. "F5" aus.
Um einen Breakpoint zu definieren, der nur dann wirkt, wenn das Script während der Druckaufbereitung aufgerufen wird, können Sie folgende Codezeilen einfügen:
if (!theDoc.InDesignMode)
theDoc.ToString();
Setzen Sie den Breakpoint auf die 2. der beiden Zeilen. Der Breakpoint wird erst dann aktiviert, wenn die Druckaufbereitung des Beleges läuft.
Debugging mit Änderungen OnTheFly
Die Microsoft Entwicklungsumgebung erlaubt auch die Veränderung der Quelldatei während einer Debug-Sitzung.
Diese Einstellungen sind zum Debuggen nicht notwendig, erlauben aber ein komfortableres Debugging.
Um diese Möglichkeit zu nutzen, sind einige weitere Voraussetzungen zu erfüllen:
Geben Sie als Referenzassembly Ihrer Klassenbibliothek die Assemblies "SOG.Base.dll" und "SOG.Base.Extension.SOGForms.dll" z.B. aus dem aktuelle bin-Verzeichnis an.
Kopieren Sie Ihr Script als ".cs" Datei in Ihre Klassenbibliothek.
Erweitern Sie die Originaldatei um die Zeilen:
// *ASM*D:/dev/hdldev/todev/test/tscript/bin/Debug/tscript.dll
// *REF*END*
Geben Sie hinter *ASM* den Debug-Ausgabenamen Ihrer Klassenbibliothek an.
Nun kann das Script verändert werden, während die Ausführung läuft, wenn es sich z.B. auf einem Break-Point befindet.
Vergessen Sie nicht, die Änderungen die Sie an der Kopie Ihres Scriptes machen, später wieder in die Originaldatei zurückzukopieren.
Vergessen Sie nicht, die "*ASM*" Zeile aus dem Original-Script wieder zu entfernen. Ansonsten macht es später den Eindruck, als wenn man das Script nicht mehr ändern könnte, da ja immer die fertig übersetzte Version aus dem angegebenen Assembly genutzt wird.