EventLogTraceListener Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tillhandahåller en enkel lyssnare som dirigerar spårning eller felsökning av utdata till en EventLog.
public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class EventLogTraceListener : System.Diagnostics.TraceListenertype EventLogTraceListener = class
inherit TraceListenerPublic NotInheritable Class EventLogTraceListener
Inherits TraceListener- Arv
Exempel
I följande exempel skapas en spårningslyssnare som skickar utdata till en händelselogg. Först skapar koden en ny EventLogTraceListener som använder källan myEventLogSource.
myTraceListener Sedan läggs den till i Trace.Listeners samlingen. Slutligen skickar exemplet en utdatarad till Listeners objektet.
// 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
Kommentarer
En instans av detta EventLogTraceListener kan läggas till i samlingarna Debug.Listeners, Trace.Listenerseller TraceSource.Listeners för att skicka utdata från spårning eller felsökning till en EventLog. Du kan lägga till instansen i koden eller, för en .NET Framework-app, ange den i programkonfigurationsfilen.
Om du vill lägga till en EventLogTraceListener med hjälp av en .NET Framework-programkonfigurationsfil redigerar du filen som motsvarar namnet på ditt program. I den här filen infogar du ett element för en System.Diagnostics.EventLogTraceListener typ. I följande exempel läggs ett EventLogTraceListener objekt med namnet myListener till Trace.Listeners samlingen. Parametern initializeData anger namnet på den händelseloggkälla som ska skickas till EventLogTraceListener(String) konstruktorn.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="myListener"
type="System.Diagnostics.EventLogTraceListener"
initializeData="TraceListenerLog" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Note
Source Om för händelseloggen som är associerad med instansen EventLogTraceListener inte finns skapas en ny händelsekälla. Om du vill skapa en händelsekälla i Windows Vista, Windows XP Professional eller Windows Server 2003 måste du ha administratörsbehörighet.
Orsaken till det här kravet är att alla händelseloggar, inklusive säkerhet, måste sökas igenom för att avgöra om händelsekällan är unik. I Windows Vista har användarna inte behörighet att komma åt säkerhetsloggen. Därför genereras en SecurityException.
I Windows Vista bestämmer UAC (User Account Control) en användares behörigheter. Om du är medlem i gruppen Inbyggda administratörer tilldelas du två åtkomsttoken för körning: en standardåtkomsttoken för användare och en administratörsåtkomsttoken. Som standard är du i standardanvändarrollen. Om du vill köra koden som kommer åt säkerhetsloggen måste du först höja dina privilegier från standardanvändare till administratör. Du kan göra detta när du startar ett program genom att högerklicka på programikonen och ange att du vill köra som administratör.
Klassen tillhandahåller EventLog egenskapen för att hämta eller ange händelseloggen som tar emot spårnings- eller felsökningsutdata och Name egenskapen som ska innehålla namnet på EventLogTraceListener.
Metoden Close stänger händelseloggen så att den inte längre tar emot spårning eller felsökning av utdata. Metoderna Write och WriteLine skriver ett meddelande till händelseloggen.
Note
För att undvika möjligheten att skriva stora mängder data till händelseloggen EventLogTraceListener matar inte ut valfria spårningsdata som anges av TraceOutputOptions egenskapen.
Konstruktorer
| Name | Description |
|---|---|
| EventLogTraceListener() |
Initierar en ny instans av EventLogTraceListener klassen utan spårningslyssnare. |
| EventLogTraceListener(EventLog) |
Initierar en ny instans av klassen med hjälp av EventLogTraceListener den angivna händelseloggen. |
| EventLogTraceListener(String) |
Initierar en ny instans av EventLogTraceListener klassen med den angivna källan. |
Egenskaper
| Name | Description |
|---|---|
| Attributes |
Hämtar attributen för anpassad spårningslyssnare som definierats i programkonfigurationsfilen. (Ärvd från TraceListener) |
| EventLog |
Hämtar eller anger händelseloggen som ska skrivas till. |
| Filter |
Hämtar eller anger spårningsfiltret för spårningslyssnaren. (Ärvd från TraceListener) |
| IndentLevel |
Hämtar eller anger indragsnivån. (Ärvd från TraceListener) |
| IndentSize |
Hämtar eller anger antalet blanksteg i ett indrag. (Ärvd från TraceListener) |
| IsThreadSafe |
Hämtar ett värde som anger om spårningslyssnaren är trådsäker. (Ärvd från TraceListener) |
| Name |
Hämtar eller anger namnet på den här EventLogTraceListener. |
| NeedIndent |
Hämtar eller anger ett värde som anger om utdata ska dras in. (Ärvd från TraceListener) |
| TraceOutputOptions |
Hämtar eller anger alternativen för spårningsutdata. (Ärvd från TraceListener) |
Metoder
| Name | Description |
|---|---|
| Close() |
Stänger händelseloggen så att den inte längre tar emot spårning eller felsökning av utdata. |
| CreateObjRef(Type) |
Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject) |
| Dispose() |
Släpper alla resurser som används av TraceListener. (Ärvd från TraceListener) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av TraceListener och släpper eventuellt de hanterade resurserna. (Ärvd från TraceListener) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| Fail(String, String) |
Genererar ett felmeddelande och ett detaljerat felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Fail(String) |
Genererar ett felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Flush() |
När den åsidosättas i en härledd klass töms utdatabufferten. (Ärvd från TraceListener) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetLifetimeService() |
Föråldrad.
Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| GetSupportedAttributes() |
Hämtar anpassade attribut som stöds av spårningslyssnaren. (Ärvd från TraceListener) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| InitializeLifetimeService() |
Föråldrad.
Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MemberwiseClone(Boolean) |
Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object, TraceEventCache, String, TraceEventType, Int32, Object) |
Skriver spårningsinformation, ett dataobjekt och händelseinformation till händelseloggen. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Skriver spårningsinformation, ett dataobjekt och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[], TraceEventCache, String, TraceEventType, Int32, Object[]) |
Skriver spårningsinformation, en matris med dataobjekt och händelseinformation till händelseloggen. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Skriver spårningsinformation, en matris med dataobjekt och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[], TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Skriver spårningsinformation, en formaterad matris med objekt och händelseinformation till händelseloggen. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Skriver spårningsinformation, en formaterad matris med objekt och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, TraceEventCache, String, TraceEventType, Int32, String) |
Skriver spårningsinformation, ett meddelande och händelseinformation till händelseloggen. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Skriver spårningsinformation, ett meddelande och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Skriver spårnings- och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Skriver spårningsinformation, ett meddelande, en relaterad aktivitetsidentitet och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| Write(Object, String) |
Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Write(Object) |
Skriver värdet för objektets ToString() -metod till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Write(String, String) |
Skriver ett kategorinamn och ett meddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Write(String) |
Skriver ett meddelande till händelseloggen för den här instansen. |
| WriteIndent() |
Skriver indraget till lyssnaren som du skapar när du implementerar den här klassen och återställer NeedIndent egenskapen till |
| WriteLine(Object, String) |
Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen, följt av en radavgränsare. (Ärvd från TraceListener) |
| WriteLine(Object) |
Skriver värdet för objektets ToString() -metod till lyssnaren du skapar när du implementerar TraceListener klassen, följt av en radavslutare. (Ärvd från TraceListener) |
| WriteLine(String, String) |
Skriver ett kategorinamn och ett meddelande till lyssnaren som du skapar när du implementerar TraceListener klassen, följt av en radavgränsare. (Ärvd från TraceListener) |
| WriteLine(String) |
Skriver ett meddelande till händelseloggen för den här instansen. |
Gäller för
Trådsäkerhet
Den här typen är trådsäker.
