<trace><listeners><add> 的 <filter> 元素
将筛选器添加到跟踪的 Listeners
集合中的侦听器。
configuration
<system.diagnostics>
<trace>
<listeners>
<add>
<filter>
语法
<filter
type="traceFilterClassName"
initializeData="data" />
特性和元素
下列各节描述了特性、子元素和父元素。
特性
属性 | 描述 |
---|---|
type |
必需的特性。 指定筛选器的类型,该类型应继承自 TraceFilter 类。 你可以使用类型的命名空间限定名称,该名称与类型的 FullName 属性相对应,或者你可以使用包含程序集信息(与 AssemblyQualifiedName 属性相对应)的完全限定的类型名称。 有关完全限定的类型名称的信息,请参阅指定完全限定的类型名称。 |
initializeData |
可选特性。 传递给指定筛选器类的构造函数的字符串。 |
子元素
无。
父元素
元素 | 说明 |
---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
system.diagnostics |
指定用于收集、存储和路由消息的跟踪侦听器以及对跟踪开关设置的级别。 |
trace |
包含用于收集、存储和路由跟踪消息的侦听器。 |
listeners |
包含用于收集、存储和路由跟踪消息的侦听器。 侦听器将跟踪输出定向到相应的目标。 |
add |
将侦听器添加到 Listeners 集合中。 |
备注
<filter>
元素必须包含在指定侦听器类型的跟踪侦听器的 <add>
元素中,而不只是包含在 <sharedListeners> 定义的侦听器名称中。 如果侦听器是在 <sharedListeners> 中定义的,则必须在该元素中定义该侦听器的筛选器。
此元素可在计算机配置文件 (Machine.config) 和应用程序配置文件中使用。
示例
以下示例演示如何使用 <filter>
元素将筛选器添加到跟踪的 Listeners
集合中的侦听器 console
,并将筛选器事件级别指定为 Error
。
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener" >
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Error" />
</add>
<remove name="Default" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将推出:在整个 2024 年,我们将逐步取消以“GitHub 问题”作为内容的反馈机制,并将其替换为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈