EventLogTraceListener Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Zdroj:

EventLogTraceListener.cs

Poskytuje jednoduchý naslouchací proces, který směruje trasování nebo ladění výstupu na .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

Dědičnost

Object

MarshalByRefObject

TraceListener

EventLogTraceListener

Příklady

Následující příklad vytvoří naslouchací proces trasování, který odesílá výstup do protokolu událostí. Nejprve kód vytvoří nový EventLogTraceListener , který používá zdroj myEventLogSource. myTraceListener Dále se přidá do Trace.Listeners kolekce. Nakonec příklad odešle do objektu řádek výstupu Listeners .

// 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

Poznámky

Do objektu , nebo kolekcí lze přidat instanci, EventLogTraceListener která odesílá výstup z trasování nebo ladění do objektu EventLog.TraceSource.ListenersTrace.ListenersDebug.Listeners Instanci můžete přidat do kódu nebo pro aplikaci .NET Framework ji zadat v konfiguračním souboru aplikace.

Chcete-li přidat pomocí konfiguračního EventLogTraceListener souboru aplikace rozhraní .NET Framework, upravte soubor, který odpovídá názvu vaší aplikace. V tomto souboru vložte prvek pro System.Diagnostics.EventLogTraceListener typ. Následující příklad přidá objekt pojmenovaný EventLogTraceListenermyListener do Trace.Listeners kolekce. Parametr initializeData určuje název zdroje protokolu událostí, který se má předat konstruktoru EventLogTraceListener(String) .

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

Poznámka:

Source Pokud protokol událostí přidružený k EventLogTraceListener instanci neexistuje, vytvoří se nový zdroj událostí. Chcete-li vytvořit zdroj událostí v systému Windows Vista, Windows XP Professional nebo Windows Server 2003, musíte mít oprávnění správce.

Důvodem tohoto požadavku je, že je nutné vyhledat všechny protokoly událostí, včetně zabezpečení, aby bylo možné určit, jestli je zdroj události jedinečný. V systému Windows Vista nemají uživatelé oprávnění pro přístup k protokolu zabezpečení; SecurityException proto je vyvolán.

V systému Windows Vista určuje řízení uživatelských účtů (UAC) oprávnění uživatele. Pokud jste členem předdefinované skupiny Administrators, máte přiřazené dva přístupové tokeny za běhu: standardní přístupový token uživatele a přístupový token správce. Ve výchozím nastavení jste ve standardní roli uživatele. Pokud chcete spustit kód, který přistupuje k protokolu zabezpečení, musíte nejprve zvýšit oprávnění od standardního uživatele na správce. Můžete to udělat, když spustíte aplikaci tak, že kliknete pravým tlačítkem myši na ikonu aplikace a označíte, že chcete spustit jako správce.

Třída poskytuje EventLog vlastnost pro získání nebo nastavení protokolu událostí, který přijímá trasování nebo ladění výstupu, a Name vlastnost pro uložení názvu EventLogTraceListener.

Metoda Close zavře protokol událostí, takže už nepřijímá trasování nebo ladění výstupu. Metody Write a WriteLine metody zapisuje zprávu do protokolu událostí.

Poznámka:

Aby se zabránilo možnosti zápisu velkých objemů dat do protokolu událostí, EventLogTraceListener nevypíše nepovinná data trasování zadaná vlastností TraceOutputOptions .

Konstruktory

Name	Description
EventLogTraceListener()	Inicializuje novou instanci EventLogTraceListener třídy bez naslouchacího procesu trasování.
EventLogTraceListener(EventLog)	Inicializuje novou instanci EventLogTraceListener třídy pomocí zadaného protokolu událostí.
EventLogTraceListener(String)	Inicializuje novou instanci EventLogTraceListener třídy pomocí zadaného zdroje.

Vlastnosti

Name	Description
EventLog	Získá nebo nastaví protokol událostí pro zápis.
Name	Získá nebo nastaví název tohoto EventLogTraceListener.

Metody

Name	Description
Close()	Zavře protokol událostí, aby přestal přijímat výstup trasování nebo ladění.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapisuje do protokolu událostí informace o trasování, datový objekt a informace o událostech.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje do protokolu událostí informace o trasování, pole datových objektů a informace o událostech.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapisuje do protokolu událostí informace o trasování, formátované pole objektů a informace o událostech.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapisuje do protokolu událostí informace o trasování, zprávu a informace o událostech.
Write(String)	Zapíše zprávu do protokolu událostí pro tuto instanci.
WriteLine(String)	Zapíše zprávu do protokolu událostí pro tuto instanci.

Bezpečný přístup z více vláken

Tento typ je bezpečný pro přístup z více vláken.

Viz také

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