Microsoft Point of Service for .NET (POS for .NET) 包含用于记录 POS for .NET、服务对象和应用程序事件的日志记录功能。 日志记录参数是从 POS for .NET 注册表项 \HKLM\SOFTWARE\POSfor.NET\Logging 中读取的,条目是使用 Logger 类写入的。
启用日志记录
当注册表项 \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled 设置为任何非零值时,将启用日志记录。
日志文件大小
最大日志文件大小是在注册表项 \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB 中指定的。 如果在启用日志记录时超出此文件大小,日志记录将停止。 不会向应用程序返回任何异常或错误。
默认情况下,最大日志文件大小为 10 MB。
日志文件位置
注册表项 \HKLM\SOFTWARE\POSfor.NET\Logging\___location 用于确定日志文件的写入位置。
默认情况下,此位置设置为环境变量 %TEMP%,在 Windows 中,默认为目录 C:\Documents and Settings\(username)\Local Settings\temp。这是每用户目录。
日志文件名
日志文件名由三个元素组成:
- 注册表项 \HKLM\SOFTWARE\POSfor.NET\Logging\Name 中包含的基文件名。 此值默认为 PosFor.Net。
- 采用以下格式的时间戳:(yyyy-mm-dd hh-mm-ssZ)
- 文件扩展名 .txt。
下面是典型日志文件名的示例:
PosFor.Net(2006-08-10 18-33-29Z).txt
日志文件标头
包含用户、OS、调用线程和进程等信息的标头在创建时写入每个日志文件。 此标头包括以下字段:
- 当前用户:当前用户的名称。
- 计算机名称:创建日志的计算机的名称。
- OS 版本:正在运行的 Windows 版本,包括 Service Pack。
- .Net 运行时:.NET 运行时的版本。
- 进程 ID:创建日志文件的进程的 PID。
- 线程 ID:创建日志的线程。
- 最大日志文件大小:要用于此日志文件的最大文件大小。
- 文件:创建日志文件的可执行文件的名称。
- 内部名称:可执行文件的内部名称。
- 原始文件名:可执行文件的原始名称。
- 文件版本:存储在可执行文件中的版本信息。
- 文件说明:存储在可执行文件中的说明。
- 产品:存储在可执行文件中的产品说明。
- 产品版本:存储在可执行文件中的文件版本。
- 调试:调试标志。
- 已修补:已修补文件。
- 预发行版:预发行版标志。
- 专用内部版本:专用内部版本标志。
- 特殊内部版本:特殊内部版本标志。
- 语言:用于创建日志文件的语言。
日志文件条目
日志条目可以由 POS for .NET 创建,也可以由应用程序或服务对象创建。 通过在记录器类的实例上调用合适的方法来创建条目。
每个条目包含以下字段:
Timestamp。
创建条目的线程 ID。
重要性级别。 每个日志条目都标有其重要性级别,该级别由所涉及的记录器方法确定。
日志条目中的重要性标记 相应的记录器方法 INFO Logger.Info WARNING Logger.Warning ERROR Logger.Error 由调用记录器方法的代码指定的名称字符串。 此字符串是在调用记录器方法时指定的,不一定包含可执行文件的名称。
例如,日志文件中的典型条目将如下所示:[8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Entering LoadExplorer()
注释
如果打开了日志文件,并且应用程序调用 Refresh() 方法,则会关闭该文件,并使用更新的时间戳创建一个新文件。