WDTF 对象 日志记录 是 WDTF 中的一项功能，使 WDTF 对象能够自动将日志消息写入通用日志文件。 对象日志记录文件的名称称为TestTextLog.log。 WDTF 对象日志记录具有两个关键优势。 它通过使用 WDTF 对象方法记录高级方法调用、方法的参数和方法的结果来简化测试脚本创作。 WDTF 对象日志记录还提供一致的机制来编写常见日志消息，从而提高可诊断性。
默认情况下，WDTF 对象日志记录处于禁用状态。 通过调用 IWDTFConfig2：：EnableObjectLogging 方法启用对象日志记录。 启用日志记录后，可以通过调用 IWDTFAction2::EnableObjectLogging、IWDTFAction2::DisableObjectLogging、IWDTFActions2::EnableObjectLogging 和 IWDTFActions2::DisableObjectLogging 来暂时禁用或重新启用特定操作或操作集合的日志记录。
WDTF 写入日志文件的日志消息具有常见的模式。
<OBJECT_NAME> : <TYPE> : - <METHOD_NAME>(<METHOD_PARAMS>) <Additional Info>
<OBJECT_NAME> : <TYPE> : Target: <DisplayName>
以下示例显示了为示例系统启用日志记录时对 DeviceDepot.Query（“Volume：：”） 的调用日志记录输出。
[ Output ]
WDTF_TARGETS : INFO : - Query("Volume::")
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: HL-DT-ST RW/DVD MU10N ATA Device
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: Generic volume
如果启用了对象日志记录，则默认启用对象错误日志记录。 否则，错误日志记录默认为禁用。 与对象日志记录一样，可以通过调用 IWDTFConfig2::EnableObjectErrorLogging、IWDTFConfig2::DisableObjectErrorLogging、IWDTFAction2::EnableObjectErrorLogging、IWDTFAction2::DisableObjectErrorLogging、IWDTFActions2::EnableObjectErrorLogging 和 IWDTFActions2::DisableObjectErrorLogging 来启用/禁用错误日志记录。
WDTF 写入日志文件进行错误日志记录的日志消息具有以下模式。 查找关键字“ERROR”以跳转到日志中的第一个错误。
<OBJECT_NAME> : <TYPE> : - <METHOD_NAME>(<METHOD_PARAMS>) <Additional Info>
<OBJECT_NAME> : <TYPE> : Target: <DisplayName>
<OBJECT_NAME> : ERROR : Status: <ErrorString>
你仍可以选择通过调用 IWDTFLog2：：OutputInfo 或 IWDTFLog2：：OutputError 方法将自定义消息写入日志文件。
有关可用对象的列表，请参阅 WDTF 对象名称标记。