Partager via

Écriture d'informations dans le journal des événements

  • Article

Il est possible de contrôler la progression des divers processus d'entreprise de votre application BizTalk en écrivant des informations dans le journal de l'application ou un journal des événements personnalisé. L'écriture d'informations dans le journal des événements peut s'avérer utile dans les situations suivantes  :

  • vous voulez accéder aux messages de l'application de manière standard à l'aide des outils fournis par Windows ;

  • vous voulez archiver des informations ainsi que d'autres messages de l'environnement serveur afin d'obtenir un historique plus complet ;

  • vous voulez pouvoir contrôler votre application à l'aide d'outils qui interagissent avec le journal des événements.

Notes

La taille de la méthode System.Diagnostics.EventLog.WriteEntry est limitée sur la chaîne de message. Si cette chaîne dépasse 32 766 octets, un message d'exception s'affiche.

Écriture dans le journal de l'application

Vous pouvez écrire dans le journal des applications ou tout autre journal à partir de votre code à l’aide de System.Diagnostics.EventLog , comme indiqué dans les éléments suivants :

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

De la même manière, vous pouvez utiliser :

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

Si vous utilisez un journal personnalisé, vous devez utiliser la méthode SourceExists pour vous assurer qu’il existe avant d’y écrire.

Écriture dans un journal personnalisé

L'écriture dans un journal personnalisé est similaire à l'écriture dans le journal de l'application, à ceci près que vous devez d'abord créer le journal personnalisé. Voici le code à utiliser pour créer un journal personnalisé :

// 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");  
}

Cependant, votre code ne pourra être exécuté par un compte qui dispose des privilèges de sécurité suffisants pour la création d'un nouveau journal des événements. En effet, la création d'un journal des événements requiert également des privilèges d'administrateur et doit être effectuée dans un utilitaire distinct ou, idéalement, dans le cadre d'une installation .msi. Pour plus d’informations sur l’utilisation d’un script personnalisé avec une installation de .msi exportée, consultez Utilisation de scripts de prétraitement et de post-traitement pour personnaliser le déploiement d’applications.