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 Ablaufverfolgungs- und Debugausgaben an ein EventLog leitet.
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. Als Nächstes myTraceListener wird der Trace.Listeners Auflistung hinzugefügt. Schließlich sendet das Beispiel eine Ausgabezeile an das Listeners -Objekt.
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
Hinweise
Eine instance davon EventLogTraceListener kann der Debug.Listeners- oder -Auflistung hinzugefügt werden, TraceSource.ListenersTrace.Listenersum die Ausgabe aus der Ablaufverfolgung oder dem Debuggen an eine EventLogzu senden. Sie können die instance im Code hinzufügen oder für eine .NET Framework-App in der Anwendungskonfigurationsdatei angeben.
Um eine EventLogTraceListener mithilfe einer .NET Framework Anwendungskonfigurationsdatei hinzuzufügen, 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 Trace.Listeners Auflistung ein EventLogTraceListener Objekt mit dem Namen myListener hinzugefügt. 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 für Source das Ereignisprotokoll, das dem EventLogTraceListener instance zugeordnet ist, nicht vorhanden ist, wird eine neue Ereignisquelle erstellt. Um eine Ereignisquelle in Windows Vista, Windows XP Professional oder Windows Server 2003 zu erstellen, müssen Sie über Administratorrechte verfügen.
Der Grund für diese Anforderung ist, dass alle Ereignisprotokolle, einschließlich der Sicherheit, durchsucht werden müssen, um festzustellen, ob die Ereignisquelle eindeutig ist. In Windows Vista verfügen Benutzer nicht über die Berechtigung zum Zugriff auf das Sicherheitsprotokoll. daher wird ein SecurityException ausgelöst.
Unter Windows Vista werden die Berechtigungen eines Benutzers über die Benutzerkontensteuerung (User Account Control, UAC) bestimmt. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf das Sicherheitsprotokoll zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer auf den Administrator erhöhen. Dazu starten Sie eine Anwendung, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie die Anwendung als Administrator ausführen möchten.
Die -Klasse stellt die EventLog -Eigenschaft zum Abrufen oder Festlegen des Ereignisprotokolls bereit, das die Ablaufverfolgungs- oder Debugausgabe empfängt, und die Name -Eigenschaft, um den Namen von EventLogTraceListenerzu enthalten.
Die Close -Methode schließt das Ereignisprotokoll, sodass sie keine Ablaufverfolgungs- oder Debugausgabe mehr empfängt. Die Write Methoden und WriteLine schreiben eine Nachricht in das Ereignisprotokoll.
Hinweis
Um zu vermeiden, dass große Datenmengen in das Ereignisprotokoll geschrieben werden können, gibt der EventLogTraceListener die optionalen Ablaufverfolgungsdaten, die von der TraceOutputOptions -Eigenschaft angegeben sind, nicht aus.
Konstruktoren
| EventLogTraceListener() |
Initialisiert eine neue Instanz der EventLogTraceListener-Klasse ohne Ablaufverfolgungslistener. |
| EventLogTraceListener(EventLog) |
Initialisiert eine neue Instanz der EventLogTraceListener-Klasse unter Verwendung des angegebenen Ereignisprotokolls. |
| EventLogTraceListener(String) |
Initialisiert eine neue Instanz der EventLogTraceListener-Klasse unter Verwendung der angegebenen Quelle. |
Eigenschaften
| Attributes |
Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von TraceListener) |
| EventLog |
Ruft das Ereignisprotokoll ab, in das geschrieben werden soll, oder legt dieses fest. |
| Filter |
Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest. (Geerbt von TraceListener) |
| IndentLevel |
Ruft die Einzugsebene ab oder legt diese fest. (Geerbt von TraceListener) |
| IndentSize |
Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest. (Geerbt von TraceListener) |
| IsThreadSafe |
Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist. (Geerbt von TraceListener) |
| Name |
Ruft den Namen dieser EventLogTraceListener ab oder legt diesen fest. |
| NeedIndent |
Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest. (Geerbt von TraceListener) |
| TraceOutputOptions |
Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest. (Geerbt von TraceListener) |
Methoden
| Close() |
Schließt das Ereignisprotokoll, sodass keine Ablaufverfolgungs- oder Debugausgaben mehr empfangen werden. |
| CreateObjRef(Type) |
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
| Dispose() |
Gibt alle vom TraceListener verwendeten Ressourcen frei. (Geerbt von TraceListener) |
| Dispose(Boolean) |
Gibt die von TraceListener verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von TraceListener) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| Fail(String) |
Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| Fail(String, String) |
Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| Flush() |
Entleert beim Überschreiben in einer abgeleiteten Klasse den Ausgabepuffer. (Geerbt von TraceListener) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetSupportedAttributes() |
Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab. (Geerbt von TraceListener) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie des 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 Datenobjekt und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in das Ereignisprotokoll. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in das Ereignisprotokoll. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein formatiertes Objektarray und Ereignisinformationen in das Ereignisprotokoll. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Schreibt Ablaufverfolgungsinformationen, eine Meldung, eine verwandte Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| Write(Object) |
Schreibt den Wert der ToString()-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| Write(Object, String) |
Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| Write(String) |
Schreibt eine Meldung in das Ereignisprotokoll für diese Instanz. |
| Write(String, String) |
Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| WriteIndent() |
Schreibt den Einzug in den Listener, den sie bei der Implementierung dieser Klasse erstellen, und setzt die NeedIndent-Eigenschaft auf |
| WriteLine(Object) |
Schreibt den Wert der ToString()-Methode des Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| WriteLine(Object, String) |
Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| WriteLine(String) |
Schreibt eine Meldung in das Ereignisprotokoll für diese Instanz. |
| WriteLine(String, String) |
Schreibt einen Kategorienamen und eine Meldung gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
Gilt für:
Threadsicherheit
Dieser Typ ist threadsicher.
