Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

EventLogTraceListener-Klasse

 

Veröffentlicht: Oktober 2016

Stellt einen einfachen Listener, der leitet Ablaufverfolgungs- oder um einen EventLog.

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.EventLogTraceListener

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public sealed class EventLogTraceListener : TraceListener

NameBeschreibung
System_CAPS_pubmethodEventLogTraceListener()

Initialisiert eine neue Instanz der EventLogTraceListener -Klasse ohne Ablaufverfolgungslistener.

System_CAPS_pubmethodEventLogTraceListener(EventLog)

Initialisiert eine neue Instanz der EventLogTraceListener -Klasse unter Verwendung des angegebenen Ereignisprotokolls.

System_CAPS_pubmethodEventLogTraceListener(String)

Initialisiert eine neue Instanz der EventLogTraceListener -Klasse unter Verwendung der angegebenen Quelle.

NameBeschreibung
System_CAPS_pubpropertyAttributes

Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyEventLog

Ruft ab oder legt das Ereignisprotokoll zu schreiben.

System_CAPS_pubpropertyFilter

Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab und legt diesen fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyIndentLevel

Ruft die Einzugsebene ab oder legt diese fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyIndentSize

Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyIsThreadSafe

Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyName

Ruft ab oder legt den Namen dieses EventLogTraceListener.(Überschreibt TraceListener.Name.)

System_CAPS_pubpropertyTraceOutputOptions

Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest.(Geerbt von „TraceListener“.)

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt das Ereignisprotokoll, sodass dieser Ablaufverfolgungs-oder Debugausgaben mehr empfängt.(Überschreibt TraceListener.Close().)

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodDispose()

Gibt alle vom TraceListener verwendeten Ressourcen frei.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodFail(String)

Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodFail(String, String)

Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodFlush()

Entleert beim Überschreiben in einer abgeleiteten Klasse den Ausgabepuffer.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodGetSupportedAttributes()

Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in das Ereignisprotokoll geschrieben.(Überschreibt TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object).)

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in das Ereignisprotokoll geschrieben.(Überschreibt TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]).)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32)

Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in das Ereignisprotokoll geschrieben.(Überschreibt TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String).)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in das Ereignisprotokoll geschrieben.(Überschreibt TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]).)

System_CAPS_pubmethodTraceTransfer(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“.)

System_CAPS_pubmethodWrite(Object)

Schreibt den Wert der ToString-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodWrite(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“.)

System_CAPS_pubmethodWrite(String)

Schreibt eine Meldung in das Ereignisprotokoll für diese Instanz.(Überschreibt TraceListener.Write(String).)

System_CAPS_pubmethodWrite(String, String)

Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodWriteLine(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“.)

System_CAPS_pubmethodWriteLine(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“.)

System_CAPS_pubmethodWriteLine(String)

Schreibt eine Meldung in das Ereignisprotokoll für diese Instanz.(Überschreibt TraceListener.WriteLine(String).)

System_CAPS_pubmethodWriteLine(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“.)

Eine Instanz dieses EventLogTraceListener können hinzugefügt werden die Debug.Listeners, Trace.Listeners, oder TraceSource.Listeners Sammlungen, um die Ausgabe von Ablaufverfolgungs- oder um eine EventLog. Sie können die Instanz im Code hinzufügen oder es in der Anwendungskonfigurationsdatei angeben. Hinzufügen einer EventLogTraceListener mithilfe einer Anwendungskonfigurationsdatei bearbeiten Sie die Datei, die den Namen der Anwendung entspricht, oder die Datei app.config in einem Visual Studio 2005 Projekt. Fügen Sie in dieser Datei ein Element für einen System.Diagnostics.EventLogTraceListener Typ.

Im folgenden Beispiel wird ein EventLogTraceListener -Objekt namens myListener an der Trace.Listeners Auflistung. Die initializeData Parameter gibt den Namen der Ereignisprotokollquelle, die übergeben werden die EventLogTraceListener(String) Konstruktor.

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

Weitere Informationen zum Hinzufügen von Ablaufverfolgungslistenern in der Anwendungskonfigurationsdatei finden Sie unter oder.

System_CAPS_noteHinweis

Wenn die Source für das Ereignisprotokoll, die zugeordnet ist die EventLogTraceListener Instanz vorhanden ist, wird eine neue Ereignisquelle erstellt. Zum Erstellen einer Ereignisquelle in Windows Vista, Windows XP Professional oder Windows Server 2003 müssen Sie über Administratorrechte verfügen.

Der Grund für diese Anforderung ist, dass alle Ereignisprotokolle, einschließlich Sicherheit, durchsucht werden müssen, um zu bestimmen, ob die Ereignisquelle eindeutig ist. In Windows Vista verfügen Benutzer nicht über die Berechtigung zum Zugriff auf das Sicherheitsprotokoll; aus diesem Grund eine 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 von Standardbenutzer auf 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 der im Ereignisprotokoll, die die Ablaufverfolgung oder Debuggen Ausgabe empfängt und die Name mit dem Namen der Eigenschaft der EventLogTraceListener.

Die Close Methode schließt das Ereignisprotokoll, sodass es nicht mehr empfängt, Ablaufverfolgungs- oder Debugausgabe. Die Write und WriteLine Methoden eine Meldung in das Ereignisprotokoll geschrieben.

System_CAPS_noteHinweis

Vermeiden Sie die Möglichkeit, große Datenmengen in das Ereignisprotokoll schreiben der EventLogTraceListener gibt keine angegebenen optional Trace-Daten der TraceOutputOptions Eigenschaft.

Das folgende Beispiel erstellt einen Ablaufverfolgungslistener, der Ausgabe in ein Ereignisprotokoll gesendet. Der Code erstellt zunächst ein neues EventLogTraceListener verwendet die Quelle myEventLogSource. Als Nächstes myTraceListener wird hinzugefügt, der Trace.Listeners Auflistung. Im Beispiel wird schließlich eine Zeile der Ausgabe auf der Listeners Objekt.

public static void Main(string[] args) {

    // 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");
 }

.NET Framework
Verfügbar seit 1.1

Dieser Typ ist threadsicher.

Zurück zum Anfang
Anzeigen: