Probleme die auf dem Entwicklerrechner auftreten können meist leicht gefunden werden – hier kann direkt mit den üblichen Features der Entwicklungsumgebung gearbeitet werden und ein Problem so recht schnell eingegrenzt werden. Der erste Schritt besteht darin, eventuell auftretende Exceptions abzufangen und deren Ursache zu überprüfen (siehe auch Fehlerhandling mit Exceptions).

Als Entwicklungskomponente wird List & Label aber natürlich unter einer Vielzahl verschiedener Konstellationen bei den Anwendern ausgeführt. Um Probleme dort möglichst einfach zu finden, steht ein eigenes Debug-Tool zur Verfügung, das bei selten oder nur auf bestimmten Systemen auftretenden Problemen eine Protokollierungsfunktion bietet, mit deren Hilfe Probleme auch auf Systemen ohne Debugger untersucht werden können. Natürlich kann die Logging-Funktion auch auf dem Entwicklerrechner genutzt werden und bietet auch dort die Möglichkeit, sämtliche Aufrufe und Rückgabewerte schnell auf einen Blick zu prüfen.

Protokolldatei anfertigen

Tritt ein Problem nur auf einem Kundensystem auf, sollte auf diesem zunächst eine Protokolldatei erstellt werden. Hierzu dient das Tool Debwin, welches im Verzeichnis Verschiedenes der List & Label-Installation installiert wird. Debwin muss vor der Applikation gestartet werden. Über Capture List & Label Log wird die Protokollierung aktiviert. Wenn anschließend die Applikation gestartet wird, werden sämtliche Aufrufe an die Komponente mit ihren Rückgabewerten sowie einige Zusatzinformationen zu Modulversionen, Betriebssystem etc. protokolliert. Jede unter .NET geworfene Exception entspricht im Protokoll einem negativen Rückgabewert einer Funktion. Im Protokoll finden sich meist weitere hilfreiche Informationen, eine typische Ausgabe könnte wie folgt aussehen:

Man sieht zunächst die Art der Ausgabe gefolgt von der DLL, die die Ausgabe erzeugt hat. Dann kommt der Ort innerhalb von List & Label, die Thread-ID und eine Timestamp für die Ausgabe sowie den eigentlichen Aufruf mit allen Parametern. In der Folgezeile erfolgt dann die Rückgabe eines Fehlercodes (-99) und eine Erklärung dafür – in diesem Falle hat der Benutzer den Dateiauswahldialog mit "Abbrechen" beendet.

Protokollierung im Code

Soll die Anwendung ohne Hilfe des Tools Debwin Debug-Protokolle erstellen, kann dies durch die Aktivierung des Debuggings in der Komponente erreicht werden. Dafür ist es lediglich erforderlich die beiden Eigenschaften Debug und DebugLogFilePath entsprechend zu definieren.

using combit.Reporting;
...
using(ListLabel LL = new ListLabel())
{
  LL.Debug = LlDebug.Enabled | LlDebug.LogToFile;
  LL.DebugLogFilePath = @"c:\temp\myLLProtocol.log";                                 
}

Imports combit.Reporting
...
Using LL As New ListLabel

    LL.Debug = LlDebug.Enabled | LlDebug.LogToFile
    LL.DebugLogFilePath = "c:\temp\myLLProtocol.log"

End Using