EventLogTraceListener 类

提供一个简单侦听器，它将跟踪或调试输出指向 EventLog。

**命名空间:**System.Diagnostics
**程序集:**System（在 system.dll 中）

语法

声明
Public NotInheritable Class EventLogTraceListener
    Inherits TraceListener
用法
Dim instance As EventLogTraceListener

public sealed class EventLogTraceListener : TraceListener

public ref class EventLogTraceListener sealed : public TraceListener

public final class EventLogTraceListener extends TraceListener

public final class EventLogTraceListener extends TraceListener

备注

提示

应用于此类的 HostProtectionAttribute 属性 (Attribute) 具有以下 Resources 属性 (Property) 值：Synchronization。HostProtectionAttribute 不影响桌面应用程序（这些应用程序通常通过双击图标、键入命令或在浏览器中输入 URL 来启动）。有关更多信息，请参见 HostProtectionAttribute 类或 SQL Server 编程和宿主保护属性。

可以将此 EventLogTraceListener 的实例添加到 Debug.Listeners 或 Trace.Listeners 集合，以便将输出从跟踪或调试重定向到 EventLog。

该类提供 EventLog 属性，以获取或设置接收跟踪或调试输出的事件日志，该类还提供 Name 属性，以保存 EventLogTraceListener 的名称。

Close 方法关闭事件日志，以使其不再接收跟踪或调试输出。Write 和 WriteLine 方法将消息写入事件日志。

提示

为了避免向事件日志中写入大量数据的情况出现，EventLogTraceListener 不输出 TraceOutputOptions 属性所指定的可选跟踪数据。

主题	位置
演练：将 ASP.NET 跟踪与 System.Diagnostics 跟踪集成	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：将 ASP.NET 跟踪与 System.Diagnostics 跟踪集成	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：将 ASP.NET 跟踪与 System.Diagnostics 跟踪集成	生成 ASP .NET Web 应用程序

示例

下面的示例创建跟踪侦听器，它输出到事件日志。首先，代码创建一个名为 myEventLog 的事件日志。然后，创建一个使用 myEventLog 的新 EventLogTraceListener。接下来，将 myTraceListener 添加到 Trace.Listeners 集合中。最后，该示例将行输出到 Listeners 对象。

Overloads Public Shared Sub Main(args() As String)
   
    ' Create a trace listener for the event log.
    Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
    
    ' Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener)
    
    ' Write output to the event log.
    Trace.WriteLine("Test output")
End Sub 'Main

public static void Main(string[] args) {

    // Create a trace listener for the event log.
    EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");
 
    // Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener);
 
    // Write output to the event log.
    Trace.WriteLine("Test output");
 }
 

int main()
{
   
   // Create a trace listener for the event log.
   EventLogTraceListener^ myTraceListener = gcnew EventLogTraceListener( "myEventLogSource" );
   
   // Add the event log trace listener to the collection.
   Trace::Listeners->Add( myTraceListener );
   
   // Write output to the event log.
   Trace::WriteLine( "Test output" );
}

public static void main(String[] args)
{
    // Create a trace listener for the event log.
    EventLogTraceListener myTraceListener = 
        new EventLogTraceListener("myEventLogSource");

    // Add the event log trace listener to the collection.
    Trace.get_Listeners().Add(myTraceListener);

    // Write output to the event log.
    Trace.WriteLine("Test output");
} //main

继承层次结构

System.Object
   System.MarshalByRefObject
     System.Diagnostics.TraceListener
      System.Diagnostics.EventLogTraceListener

线程安全

此类型是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

EventLogTraceListener 成员
System.Diagnostics 命名空间
TraceListener
DefaultTraceListener 类
TextWriterTraceListener
EventLog 类
Stream
TextWriter
Debug 类
Trace