EventLogTraceListener Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Balíček:

System.Diagnostics.EventLog v8.0.0

Zdroj:

EventLogTraceListener.cs

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

int main()
{
   #if defined(TRACE)
   
   // 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" );
   
   #endif
}

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

Tuto instanci EventLogTraceListener lze přidat do Debug.Listenerskolekcí , Trace.Listeners, nebo TraceSource.Listeners a odeslat výstup z trasování nebo ladění do EventLog. Instanci můžete přidat do kódu nebo ji v případě aplikace .NET Framework zadat do konfiguračního souboru aplikace.

Pokud chcete přidat EventLogTraceListener konfigurační soubor aplikace rozhraní .NET Framework, upravte soubor, který odpovídá názvu vaší aplikace. Do tohoto souboru vložte prvek pro System.Diagnostics.EventLogTraceListener typ. Následující příklad přidá EventLogTraceListener objekt s názvem myListener 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 pro 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 všechny protokoly událostí, včetně zabezpečení, musí být prohledány, aby se zjistilo, jestli je zdroj událostí jedinečný. V systému Windows Vista uživatelé nemají oprávnění k přístupu k protokolu zabezpečení; SecurityException proto je vyvolán.

Ve Windows Vista nástroj Řízení uživatelských účtů (UAC) určuje oprávnění uživatele. Pokud jste členem předdefinované skupiny Administrators, máte přiřazeny dva přístupové tokeny run-time: token přístupu uživatele se standardním oprávněním a token přístupu správce. Ve výchozím nastavení máte roli standardního uživatele. Pokud chcete spustit kód, který přistupuje k protokolu zabezpečení, musíte nejprve zvýšit oprávnění ze standardního uživatele na správce. Můžete to udělat při spuštění aplikace tak, že kliknete pravým tlačítkem 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á výstup trasování nebo ladění, a Name vlastnost pro uložení názvu objektu EventLogTraceListener.

Metoda Close zavře protokol událostí, takže už nepřijímá výstup trasování nebo ladění. Metody Write a WriteLine 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 nevydává výstup volitelných dat trasování určených TraceOutputOptions vlastností.

Konstruktory

EventLogTraceListener()	Inicializuje novou instanci třídy bez trasovacího naslouchacího EventLogTraceListener procesu.
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

Attributes	Získá vlastní atributy trasovacího naslouchacího procesu definované v konfiguračním souboru aplikace. (Zděděno od TraceListener)
EventLog	Získá nebo nastaví protokol událostí pro zápis do.
Filter	Získá nebo nastaví filtr trasování pro trasovací naslouchací proces. (Zděděno od TraceListener)
IndentLevel	Získá nebo nastaví úroveň odsazení. (Zděděno od TraceListener)
IndentSize	Získá nebo nastaví počet mezer v odsazení. (Zděděno od TraceListener)
IsThreadSafe	Získá hodnotu označující, zda trasovací naslouchací proces je bezpečný z více vláken. (Zděděno od TraceListener)
Name	Získá nebo nastaví název tohoto EventLogTraceListener.
NeedIndent	Získá nebo nastaví hodnotu označující, zda odsadit výstup. (Zděděno od TraceListener)
TraceOutputOptions	Získá nebo nastaví možnosti výstupu trasování. (Zděděno od TraceListener)

Metody

Close()	Zavře protokol událostí, aby už nepřijímaly výstup trasování nebo ladění.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem TraceListener. (Zděděno od TraceListener)
Dispose(Boolean)	Uvolní nespravované prostředky používané TraceListener nástrojem a volitelně uvolní spravované prostředky. (Zděděno od TraceListener)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Fail(String)	Vygeneruje chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Fail(String, String)	Vygeneruje chybovou zprávu a podrobnou chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Flush()	Při přepsání v odvozené třídě vyprázdní výstupní vyrovnávací paměť. (Zděděno od TraceListener)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetSupportedAttributes()	Získá vlastní atributy podporované trasovacím naslouchacím procesem. (Zděděno od TraceListener)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapíše trasovací informace, datový objekt a informace o událostech do protokolu událostí.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapíše trasovací informace, pole datových objektů a informace o událostech do protokolu událostí.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapíše trasování a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapíše informace o trasování, zprávu a informace o událostech do protokolu událostí.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapíše trasovací informace, formátované pole objektů a informace o událostech do protokolu událostí.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapíše trasovací informace, zprávu, související identitu aktivity a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
Write(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(Object, String)	Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(String)	Zapíše zprávu do protokolu událostí pro tuto instanci.
Write(String, String)	Zapíše název kategorie a zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
WriteIndent()	Zapíše odsazení do naslouchacího procesu, který vytvoříte při implementaci této třídy, a resetuje NeedIndent vlastnost na false. (Zděděno od TraceListener)
WriteLine(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)
WriteLine(Object, String)	Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)
WriteLine(String)	Zapíše zprávu do protokolu událostí pro tuto instanci.
WriteLine(String, String)	Zapíše název kategorie a zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)

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