EventLogTraceListener Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen einfachen Listener bereit, der die Ablaufverfolgung oder das Debuggen der Ausgabe an eine EventLog.
public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class EventLogTraceListener : System.Diagnostics.TraceListenertype EventLogTraceListener = class
inherit TraceListenerPublic NotInheritable Class EventLogTraceListener
Inherits TraceListener- Vererbung
Beispiele
Im folgenden Beispiel wird ein Ablaufverfolgungslistener erstellt, der die Ausgabe an ein Ereignisprotokoll sendet. Zunächst erstellt der Code eine neue EventLogTraceListener , die die Quelle myEventLogSourceverwendet.
myTraceListener Als Nächstes wird der Trace.Listeners Auflistung hinzugefügt. Schließlich sendet das Beispiel eine Ausgabezeile an das Listeners Objekt.
// 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
Hinweise
Eine Instanz davon EventLogTraceListener kann dem Debug.Listeners, Trace.Listenersoder TraceSource.Listeners Sammlungen hinzugefügt werden, um die Ausgabe aus der Ablaufverfolgung oder dem Debuggen an ein EventLog. Sie können die Instanz in Ihrem Code hinzufügen oder sie für eine .NET Framework-App in der Anwendungskonfigurationsdatei angeben.
Wenn Sie eine EventLogTraceListener .NET Framework-Anwendungskonfigurationsdatei hinzufügen möchten, bearbeiten Sie die Datei, die dem Namen Ihrer Anwendung entspricht. Fügen Sie in dieser Datei ein Element für einen Typ ein System.Diagnostics.EventLogTraceListener . Im folgenden Beispiel wird der Auflistung ein EventLogTraceListener Objekt hinzugefügtmyListener.Trace.Listeners Der initializeData Parameter gibt den Namen der Ereignisprotokollquelle an, die an den EventLogTraceListener(String) Konstruktor übergeben werden soll.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="myListener"
type="System.Diagnostics.EventLogTraceListener"
initializeData="TraceListenerLog" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Hinweis
Wenn das Source ereignisprotokoll, das der EventLogTraceListener Instanz zugeordnet ist, nicht vorhanden ist, wird eine neue Ereignisquelle erstellt. Zum Erstellen einer Ereignisquelle in Windows Vista, Windows XP Professional oder Windows Server 2003 benötigen Sie Administratorrechte.
Der Grund für diese Anforderung ist, dass alle Ereignisprotokolle, einschließlich Sicherheit, durchsucht werden müssen, um festzustellen, ob die Ereignisquelle eindeutig ist. In Windows Vista verfügen Benutzer nicht über die Berechtigung für den Zugriff auf das Sicherheitsprotokoll; daher wird ein SecurityException Geworfen.
In Windows Vista bestimmt die Benutzerkontensteuerung (User Account Control, UAC) die Berechtigungen eines Benutzers. Wenn Sie Mitglied der Gruppe "Integrierte Administratoren" sind, werden Ihnen zwei Laufzeitzugriffstoken zugewiesen: ein Standardbenutzerzugriffstoken und ein Administratorzugriffstoken. Standardmäßig befinden Sie sich in der Standardbenutzerrolle. Um den Code auszuführen, der auf das Sicherheitsprotokoll zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie als Administrator ausführen möchten.
Die Klasse stellt die EventLog Eigenschaft bereit, um das Ereignisprotokoll abzurufen oder festzulegen, das die Ablaufverfolgungs- oder Debuggingausgabe empfängt, und die Name Eigenschaft, die den Namen des EventLogTraceListenerObjekts enthält.
Die Close Methode schließt das Ereignisprotokoll, sodass es keine Ablaufverfolgungs- oder Debugausgabe mehr empfängt. Die Write Methoden schreiben WriteLine eine Nachricht in das Ereignisprotokoll.
Hinweis
Um die Möglichkeit zu vermeiden, große Datenmengen in das Ereignisprotokoll zu schreiben, gibt die EventLogTraceListener durch die TraceOutputOptions Eigenschaft angegebene optionale Ablaufverfolgungsdaten nicht aus.
Konstruktoren
| Name | Beschreibung |
|---|---|
| EventLogTraceListener() |
Initialisiert eine neue Instanz der EventLogTraceListener Klasse ohne Ablaufverfolgungslistener. |
| EventLogTraceListener(EventLog) |
Initialisiert eine neue Instanz der EventLogTraceListener Klasse mithilfe des angegebenen Ereignisprotokolls. |
| EventLogTraceListener(String) |
Initialisiert eine neue Instanz der Klasse mithilfe der EventLogTraceListener angegebenen Quelle. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Attributes |
Ruft die benutzerdefinierten Listenerattribute der Ablaufverfolgung ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von TraceListener) |
| EventLog |
Ruft ab oder legt das Ereignisprotokoll fest, in das geschrieben werden soll. |
| Filter |
Dient zum Abrufen oder Festlegen des Ablaufverfolgungsfilters für den Ablaufverfolgungslistener. (Geerbt von TraceListener) |
| IndentLevel |
Dient zum Abrufen oder Festlegen der Einzugsebene. (Geerbt von TraceListener) |
| IndentSize |
Dient zum Abrufen oder Festlegen der Anzahl von Leerzeichen in einem Einzug. (Geerbt von TraceListener) |
| IsThreadSafe |
Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist. (Geerbt von TraceListener) |
| Name |
Dient zum Abrufen oder Festlegen des Namens dieses EventLogTraceListener. |
| NeedIndent |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Ausgabe eingezogen werden soll. (Geerbt von TraceListener) |
| TraceOutputOptions |
Ruft die Ausgabeoptionen für die Ablaufverfolgung ab oder legt sie fest. (Geerbt von TraceListener) |
Methoden
| Name | Beschreibung |
|---|---|
| Close() |
Schließt das Ereignisprotokoll, sodass es keine Ablaufverfolgungs- oder Debugausgabe mehr empfängt. |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| Dispose() |
Veröffentlicht alle ressourcen, die von der TraceListener. (Geerbt von TraceListener) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den TraceListener verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von TraceListener) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| Fail(String, String) |
Gibt eine Fehlermeldung und eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Fail(String) |
Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Flush() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Ausgabepuffer geleert. (Geerbt von TraceListener) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetSupportedAttributes() |
Ruft die benutzerdefinierten Attribute ab, die vom Ablaufverfolgungslistener unterstützt werden. (Geerbt von TraceListener) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in das Ereignisprotokoll. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in das Ereignisprotokoll. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in das Ereignisprotokoll. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Schreibt Ablaufverfolgungsinformationen, eine Nachricht und Ereignisinformationen in das Ereignisprotokoll. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Schreibt Ablaufverfolgungsinformationen, eine Nachricht, eine zugehörige Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| Write(Object, String) |
Schreibt einen Kategorienamen und den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Write(Object) |
Schreibt den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Write(String, String) |
Schreibt einen Kategorienamen und eine Nachricht in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Write(String) |
Schreibt eine Nachricht in das Ereignisprotokoll für diese Instanz. |
| WriteIndent() |
Schreibt den Einzug in den Listener, den Sie beim Implementieren dieser Klasse erstellen, und setzt die NeedIndent Eigenschaft auf |
| WriteLine(Object, String) |
Schreibt einen Kategorienamen und den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen, gefolgt von einem Zeilenterminator. (Geerbt von TraceListener) |
| WriteLine(Object) |
Schreibt den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen, gefolgt von einem Zeilenterminator. (Geerbt von TraceListener) |
| WriteLine(String, String) |
Schreibt einen Kategorienamen und eine Nachricht in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen, gefolgt von einem Zeilenterminator. (Geerbt von TraceListener) |
| WriteLine(String) |
Schreibt eine Nachricht in das Ereignisprotokoll für diese Instanz. |
Gilt für:
Threadsicherheit
Dieser Typ ist threadsicher.
