EventLogTraceListener Osztály

Definíció

Névtér:

System.Diagnostics

Szerelvény:

System.Diagnostics.EventLog.dll

Csomag:

System.Diagnostics.EventLog v11.0.0-rc.1.26425.128

Forrás:

EventLogTraceListener.cs

Egyszerű figyelőt biztosít, amely a kimenet nyomon követését vagy hibakeresését irányítja egy EventLog.

public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListener

public sealed class EventLogTraceListener : System.Diagnostics.TraceListener

type EventLogTraceListener = class
    inherit TraceListener

Public NotInheritable Class EventLogTraceListener
Inherits TraceListener

Öröklődés

Object

MarshalByRefObject

TraceListener

EventLogTraceListener

Példák

Az alábbi példa létrehoz egy nyomkövetési figyelőt, amely kimenetet küld egy eseménynaplóba. Először a kód létrehoz egy újat EventLogTraceListener , amely a forrást myEventLogSourcehasználja. myTraceListener Ezután hozzáadjuk a Trace.Listeners gyűjteményhez. Végül a példa egy kimenetsort küld az Listeners objektumnak.

// 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");

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

Megjegyzések

Ennek EventLogTraceListener egy példánya hozzáadható a Debug.Listeners, Trace.Listenersvagy TraceSource.Listeners gyűjteményekhez, hogy kimenetet küldjön nyomkövetésből vagy hibakeresésből egy EventLogadott gyűjteménybe. Hozzáadhatja a példányt a kódhoz, vagy egy .NET-keretrendszeralkalmazás esetében megadhatja azt az alkalmazáskonfigurációs fájlban.

Ha EventLogTraceListener szeretne hozzáadni egy .NET-keretrendszeralkalmazás konfigurációs fájlját, szerkessze az alkalmazás nevének megfelelő fájlt. Ebben a fájlban szúrjon be egy elemet egy System.Diagnostics.EventLogTraceListener típushoz. Az alábbi példa egyEventLogTraceListener, a myListener gyűjteményhez elnevezett Trace.Listeners objektumot ad hozzá. A initializeData paraméter megadja a konstruktornak átadni EventLogTraceListener(String) kívánt eseménynapló-forrás nevét.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="myListener"
          type="System.Diagnostics.EventLogTraceListener"
          initializeData="TraceListenerLog" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Note

Ha a Source példányhoz EventLogTraceListener társított eseménynapló nem létezik, létrejön egy új eseményforrás. Ha Windows Vista, Windows XP Professional vagy Windows Server 2003-ban szeretne eseményforrást létrehozni, rendszergazdai jogosultságokkal kell rendelkeznie.

Ennek a követelménynek az az oka, hogy minden eseménynaplót, beleértve a biztonságot is, keresni kell annak megállapításához, hogy az eseményforrás egyedi-e. A Windows Vista a felhasználók nem férnek hozzá a biztonsági naplóhoz, ezért a rendszer SecurityException dob.

Windows Vista rendszerben a felhasználói fiókok felügyelete (UAC) határozza meg a felhasználó jogosultságait. Ha Tagja a Beépített rendszergazdák csoportnak, két futásidejű hozzáférési jogkivonatot kap: egy standard felhasználói hozzáférési jogkivonatot és egy rendszergazdai hozzáférési jogkivonatot. Alapértelmezés szerint a szokásos felhasználói szerepkörben van. A biztonsági naplóhoz hozzáférő kód végrehajtásához először emelnie kell a jogosultságokat a standard felhasználóról a rendszergazdára. Ezt az alkalmazás indításakor megteheti úgy, hogy a jobb gombbal az alkalmazás ikonra kattint, és jelzi, hogy rendszergazdaként szeretne futni.

Az osztály biztosítja a tulajdonságot a EventLog nyomkövetési vagy hibakeresési kimenetet fogadó eseménynapló lekéréséhez vagy beállításához, a Name tulajdonság pedig a EventLogTraceListenernév tárolásához.

A Close metódus bezárja az eseménynaplót, így a továbbiakban nem kap nyomkövetési vagy hibakeresési kimenetet. A Write metódusok üzenetet WriteLine írnak az eseménynaplóba.

Note

Annak elkerülése érdekében, hogy nagy mennyiségű adatot írjon az eseménynaplóba, a EventLogTraceListener tulajdonság által megadott opcionális nyomkövetési TraceOutputOptions adatokat nem adja ki.

Konstruktorok

Name	Description
EventLogTraceListener()	Inicializálja az EventLogTraceListener osztály új példányát nyomkövetési figyelő nélkül.
EventLogTraceListener(EventLog)	Inicializálja az osztály új példányát EventLogTraceListener a megadott eseménynapló használatával.
EventLogTraceListener(String)	Inicializálja az osztály új példányát a EventLogTraceListener megadott forrás használatával.

Tulajdonságok

Name	Description
EventLog	Lekéri vagy beállítja az eseménynaplót írásra.
Name	Lekéri vagy beállítja ennek EventLogTraceListenera névnek a nevét.

Metódusok

Name	Description
Close()	Bezárja az eseménynaplót, hogy többé ne kapja meg a nyomkövetési vagy hibakeresési kimenetet.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object, TraceEventCache, String, TraceEventType, Int32, Object)	Nyomkövetési információkat, adatobjektumokat és eseményadatokat ír az eseménynaplóba.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[], TraceEventCache, String, TraceEventType, Int32, Object[])	Nyomkövetési információkat, adatobjektumok tömbét és eseményinformációkat ír az eseménynaplóba.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[], TraceEventCache, String, TraceEventType, Int32, String, Object[])	Nyomkövetési információkat, formázott objektumtömböt és eseményinformációkat ír az eseménynaplóba.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, TraceEventCache, String, TraceEventType, Int32, String)	Nyomkövetési információkat, üzenetet és eseményadatokat ír az eseménynaplóba.
Write(String)	Üzenetet ír a példány eseménynaplójába.
WriteLine(String)	Üzenetet ír a példány eseménynaplójába.

Szálbiztonság

Ez a típus szálbiztos.

Lásd még

• TraceListener
• DefaultTraceListener
• TextWriterTraceListener
• EventLog
• Stream
• TextWriter
• Debug
• Trace