Schreiben von Informationen in das Ereignisprotokoll

Möglicherweise möchten Sie den Fortschritt der verschiedenen Geschäftsprozesse in Ihrer BizTalk-Anwendung überwachen, indem Sie Informationen in das Standardanwendungsprotokoll oder in ein benutzerdefiniertes Ereignisprotokoll schreiben. Das Schreiben in das Ereignisprotokoll kann in den folgenden Szenarien hilfreich sein:

• Sie möchten standardmäßig auf Anwendungsmeldungen zugreifen, indem Sie tools verwenden, die von Windows bereitgestellt werden.

• Sie möchten Informationen mit anderen Nachrichten aus der Serverumgebung archivieren, um einen umfassenderen Verlauf zu erhalten.

• Sie möchten die Möglichkeit haben, Ihre Anwendung mithilfe von Tools zu überwachen, die mit dem Ereignisprotokoll interagieren.

Hinweis

Die System.Diagnostics.EventLog.WriteEntry-Methode hat eine Größenbeschränkung für die Nachrichtenzeichenfolge. Sie erhalten eine Ausnahme, wenn die Nachrichtenzeichenfolge 32766 Bytes überschreitet.

Schreiben in das Anwendungsprotokoll

Sie können in das Anwendungsprotokoll oder ein beliebiges anderes Protokoll aus Ihrem Code schreiben, indem Sie "System.Diagnostics.EventLog " wie in den folgenden Beispielen gezeigt verwenden:

System.Diagnostics.EventLog.WriteEntry("Orchestration Debug", System.String.Format("The Value = {0}", iResult));  

Ähnlich können Sie dies auch tun,

EventLog appLog = new EventLog();   
appLog.Source = "This Application's Name";  
appLog.WriteEntry("An entry to the Application event log.");  

Wenn Sie ein benutzerdefiniertes Protokoll verwenden, sollten Sie die SourceExists-Methode verwenden, um sicherzustellen, dass es vorhanden ist, bevor Sie in das Protokoll schreiben.

Schreiben in ein benutzerdefiniertes Protokoll

Das Schreiben in ein benutzerdefiniertes Protokoll ähnelt dem Schreiben in das Anwendungsprotokoll mit der Ausnahme, dass Sie zuerst das benutzerdefinierte Protokoll erstellen müssen. Der Code zum Erstellen eines benutzerdefinierten Protokolls ist einfach:

// Create the source, if it does not already exist. if(!EventLog.SourceExists("MySource"))   
{   
  //An event log source should not be created and immediately used.  
  //There is a latency time to enable the source, it should be created  
  //prior to executing the application that uses the source.  
  EventLog.CreateEventSource("MySource", "MyNewLog");  
}  

Sie sollten jedoch nicht davon ausgehen, dass Ihr Code unter einem Konto ausgeführt wird, das über die Sicherheitsberechtigungen zum Erstellen eines neuen Ereignisprotokolls verfügt. Das Erstellen eines Ereignisprotokolls übernimmt Administratorrechte und sollte in einem separaten Hilfsprogramm oder idealerweise als Teil einer .msi Installation erfolgen. Weitere Informationen zur Verwendung benutzerdefinierter Skripts mit einer exportierten .msi Installation finden Sie unter Verwenden von Skripts vor und nach der Verarbeitung zum Anpassen der Anwendungsbereitstellung.