将信息写入事件日志

您可能要通过将信息写入默认的应用程序日志或自定义的事件日志,监控您的 BizTalk 应用程序内的不同业务流程的进度。 在以下情况下将信息写入事件日志可能会很有用:

  • 您要使用 Windows 提供的工具以标准方法访问应用程序消息。

  • 您想要将来自服务器环境的其他消息与信息一起存档,以便获得更完整的历史记录。

  • 您想要能够使用与事件日志交互的工具监控您的应用程序。

注意

System.Diagnostics.EventLog.WriteEntry 方法对消息字符串有大小限制。 如果消息字符串超过 32766 个字节,则会发生异常。

写入应用程序日志

可以使用 System.Diagnostics.EventLog 从代码写入应用程序日志或任何其他日志,如下所示:

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

同样,您还可以写入以下内容:

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

如果使用自定义日志,则应使用 SourceExists 方法确保在写入日志之前它存在。

写入自定义日志

写入自定义日志类似于写入应用程序日志,但有一个例外,就是您必须首先创建自定义日志。 用于创建自定义日志的代码十分简单:

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

但是,您不应假定代码将基于具有创建新事件日志的安全权限的帐户运行。 创建事件日志需要管理员权限,并且应在单独的实用程序中完成,最好作为 .msi 安装的一部分完成。 有关将自定义脚本与导出 .msi 安装配合使用的详细信息,请参阅 使用预处理和后处理脚本自定义应用程序部署