如何在跟踪消息前缀中包含源行号
WPP 会自动记录有关每个跟踪消息的数据,其中大部分在默认情况下不显示。 此数据包括跟踪消息的函数名称、文件名、源行号、组件名称、子组件名称和跟踪级别。
若要在每个 跟踪消息前面的跟踪消息前缀 中显示此信息,请将预定义的前缀变量添加到 %TRACE_FORMAT_PREFIX% 环境变量中。 在设置跟踪消息格式时,Tracefmt 和其他跟踪使用者使用 %TRACE_FORMAT_PREFIX%。
例如,若要将组件名称、函数名称、文件名和行号添加到跟踪消息前缀,请将以下变量添加到 %TRACE_FORMAT_PREFIX%的值:
变量 | 说明 |
---|---|
%!COMPNAME! | 添加组件名称。 |
%!FUNC! | 添加函数名称。 |
%2 | 添加源文件的名称和跟踪语句的行号。 |
%2 变量返回以下字符串:
filename_NNN
其中点 (。 文件名中的) 替换为下划线 (_) ,NNN 是行号。
以下示例 SET 语句添加 %!COMPNAME, %!FUNC! 和 %2 变量为默认值 %TRACE_FORMAT_PREFIX%。 !s! 子参数指定 %2 的值的格式为字符串。 添加的变量以粗体文本显示。
set TRACE\_FORMAT\_PREFIX="\[%9!d!\]%8!04X!.%3!04X!::%4!s! \[%1!s!\](**%!COMPNAME!**:**%!FUNC!**:**%2**!s!)"
生成的前缀采用以下格式。 新元素显示在括号中。
[CPUNumber]ProcessID。ThreadID::SystemTime [MessageGUIDFriendlyName] (ComponentName:FunctionName:Filename_LineNumber)
有关详细示例,请参阅 示例 7:自定义跟踪消息前缀。 有关可在跟踪消息前缀中显示的所有预定义变量的列表,请参阅 跟踪消息前缀。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈