TraceSource.TraceEvent 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。
重载
| TraceEvent(TraceEventType, Int32) |
使用指定的事件类型和事件标识符，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。 |
| TraceEvent(TraceEventType, Int32, String) |
使用指定的事件类型、事件标识符和消息，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。 |
| TraceEvent(TraceEventType, Int32, String, Object[]) |
使用指定的事件类型、事件标识符以及自变量数组和格式，将跟踪事件写入 Listeners 集合中的跟踪侦听器中。 |
TraceEvent(TraceEventType, Int32)
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
使用指定的事件类型和事件标识符，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer)参数
- eventType
- TraceEventType
指定跟踪数据的事件类型的其中一个枚举值。
- id
- Int32
事件的数值标识符。
- 属性
例外
终止期间尝试跟踪事件。
示例
下面的代码示例演示如何使用 TraceEvent(TraceEventType, Int32) 方法将跟踪事件传递给侦听器。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。
ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)
注解
方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。
方法 TraceEvent 调用 ShouldTrace 属性返回的 SourceSwitch 对象的 方法 Switch 。 如果 ShouldTrace 返回 true， TraceEvent 则调用每个侦听器的相应 TraceEvent 方法。 否则， TraceEvent 返回 而不调用侦听器的方法。
跟踪内容特定于侦听器。 如果侦听器实现未重写该方法，则默认输出是跟踪源的名称、其数字标识和事件类型。 其他跟踪内容取决于侦听器的 TraceOutputOptions 属性值。
注意
对象的 EventLogTraceListener 最大值 id 限制为 65,535。
id如果指定的值大于 65,535，则 EventLogTraceListener 使用 65,535。
适用于
TraceEvent(TraceEventType, Int32, String)
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
使用指定的事件类型、事件标识符和消息，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)参数
- eventType
- TraceEventType
指定跟踪数据的事件类型的其中一个枚举值。
- id
- Int32
事件的数值标识符。
- message
- String
要写入的跟踪消息。
- 属性
例外
终止期间尝试跟踪事件。
示例
下面的代码示例演示如何使用 TraceEvent(TraceEventType, Int32) 方法将跟踪事件传递给侦听器。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。
// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");
' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")
注解
方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。
方法 TraceEvent 调用 ShouldTrace 属性返回的 SourceSwitch 对象的 方法 Switch 。 如果 ShouldTrace 返回 true， TraceEvent 则调用每个侦听器的相应 TraceEvent 方法。 否则， TraceEvent 返回 而不调用侦听器的方法。
跟踪内容特定于侦听器。 如果侦听器实现未重写方法，则默认输出是跟踪源的名称、其数字标识、事件类型和消息。 其他跟踪内容取决于侦听器的 TraceOutputOptions 属性值。
注意
对象的 EventLogTraceListener 最大值 id 限制为 65,535。
id如果指定的值大于 65,535，则EventLogTraceListener对象使用 65,535。
适用于
TraceEvent(TraceEventType, Int32, String, Object[])
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
使用指定的事件类型、事件标识符以及自变量数组和格式，将跟踪事件写入 Listeners 集合中的跟踪侦听器中。
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())参数
- eventType
- TraceEventType
指定跟踪数据的事件类型的其中一个枚举值。
- id
- Int32
事件的数值标识符。
- format
- String
包含与零个或多个格式项混合的文本的一个复合格式字符串，与 args 数组中的对象相对应。
- args
- Object[]
包含零个或多个要格式化的对象的 object 数组。
- 属性
例外
format 为 null。
终止期间尝试跟踪事件。
示例
下面的代码示例演示如何使用 TraceEvent(TraceEventType, Int32) 方法将跟踪事件传递给侦听器。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。
// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");
' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")
注解
有关 参数的详细信息 format ，请参阅 复合格式设置。
方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。
方法 TraceEvent 调用 ShouldTrace 属性返回的 SourceSwitch 对象的 方法 Switch 。 如果 ShouldTrace 返回 true， TraceEvent 则调用每个侦听器的相应 TraceEvent 方法。 否则， TraceEvent 返回 而不调用侦听器的方法。
跟踪内容特定于侦听器。 默认 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 方法在跟踪标头中写入源名称、事件类型和数字标识，然后调用 String.Format(IFormatProvider, String, Object[]) 方法，传递 format 字符串和 args 数组，并使用 CultureInfo.InvariantCulture 属性将字符串格式化为消息输出。
注意
对象的 EventLogTraceListener 最大值 id 限制为 65,535。
id如果指定的值大于 65,535，则EventLogTraceListener对象使用 65,535。
另请参阅
- 复合格式设置
- 标准数字格式字符串
- 自定义数字格式字符串
- 标准日期/时间格式字符串
- 自定义 DateTime 格式字符串
- Enumeration Format Strings
- 设置 .NET 中类型的格式
