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

Trace-Klasse

 

Veröffentlicht: Oktober 2016

Stellt einen Satz von Methoden und Eigenschaften, mit denen Sie die Ausführung des Codes verfolgen. Diese Klasse kann nicht vererbt werden.

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

System.Object
  System.Diagnostics.Trace

public sealed class Trace

NameBeschreibung
System_CAPS_pubpropertySystem_CAPS_staticAutoFlush

Ruft die Information ab, ob Flush nach jedem Schreibvorgang für Listeners aufgerufen werden soll, oder legt diese fest.

System_CAPS_pubpropertySystem_CAPS_staticCorrelationManager

Ruft den Korrelations-Manager für den Thread für diese Ablaufverfolgung ab.

System_CAPS_pubpropertySystem_CAPS_staticIndentLevel

Ruft die Einzugsebene ab oder legt diese fest.

System_CAPS_pubpropertySystem_CAPS_staticIndentSize

Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest.

System_CAPS_pubpropertySystem_CAPS_staticListeners

Ruft die Auflistung der Listener ab, durch die die Ausgabe der Ablaufverfolgung überwacht wird.

System_CAPS_pubpropertySystem_CAPS_staticUseGlobalLock

Ruft einen Wert ab, der angibt, ob die globale Sperre verwendet werden soll, oder legt diesen Wert fest.

NameBeschreibung
System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird ein Meldungsfeld mit der Aufrufliste angezeigt.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.

System_CAPS_pubmethodSystem_CAPS_staticClose()

Leert den Ausgabepuffer und schließt dann die Listeners.

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodSystem_CAPS_staticFail(String)

Gibt die angegebene Fehlermeldung aus.

System_CAPS_pubmethodSystem_CAPS_staticFail(String, String)

Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung aus.

System_CAPS_pubmethodSystem_CAPS_staticFlush()

Leert den Ausgabepuffer und führt dazu, dass gepufferte Daten in die Listeners geschrieben werden.

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetType()

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

System_CAPS_pubmethodSystem_CAPS_staticIndent()

Erhöht die aktuelle IndentLevel um 1.

System_CAPS_pubmethodSystem_CAPS_staticRefresh()

Aktualisiert die Konfigurationsdaten für die Ablaufverfolgung.

System_CAPS_pubmethodToString()

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

System_CAPS_pubmethodSystem_CAPS_staticTraceError(String)

Schreibt eine Fehlermeldung unter Verwendung der angegebenen Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticTraceError(String, Object[])

Schreibt eine Fehlermeldung unter Verwendung des angegebenen Arrays von Objekten und der Formatierungsinformationen in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticTraceInformation(String)

Schreibt eine Informationsmeldung unter Verwendung der angegebenen Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticTraceInformation(String, Object[])

Schreibt eine Informationsmeldung unter Verwendung des angegebenen Arrays von Objekten und der Formatierungsinformationen in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticTraceWarning(String)

Schreibt eine Warnmeldung unter Verwendung der angegebenen Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticTraceWarning(String, Object[])

Schreibt eine Warnmeldung unter Verwendung des angegebenen Arrays von Objekten und der Formatierungsinformationen in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticUnindent()

Verringert die aktuelle IndentLevel um 1.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object)

Schreibt den Wert der ToString-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString-Methode des Objekts in den Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, Object)

Schreibt den Wert der ToString-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, Object, String)

Schreibt einen Kategorienamen und den Wert der ToString-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object)

Schreibt den Wert der ToString-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString-Methode des Objekts in den Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, Object)

Schreibt den Wert der ToString-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, Object, String)

Schreibt einen Kategorienamen und den Wert der ToString-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.

Sie können die Eigenschaften und Methoden in der Trace Klasse zu instrumentieren erstellt. Instrumentation können Sie zum Überwachen der Integrität Ihrer Anwendung in der Realität ausgeführt wird. Können Sie Isolieren von Problemen und ohne Beeinträchtigung von einem laufenden System zu korrigieren.

Diese Klasse stellt Methoden zum Anzeigen einer Assert Dialogfeld, und die Ausgabe einer Assertion, die immer Fail. Diese Klasse stellt die Write-Methoden in den folgenden Variationen: Write, WriteLine, WriteIf, und WriteLineIf.

Die BooleanSwitch und TraceSwitch -Klasse ermöglichen die Ablaufverfolgungsausgabe dynamisch steuern. Sie können die Werte dieser Schalter ändern, ohne die Anwendung neu zu kompilieren. Informationen zum Verwenden der Konfigurationsdatei zum Festlegen eines Schalters finden Sie unter der Switch Klasse und die How to: Create, Initialize and Configure Trace Switches Thema.

Ziel der Ablaufverfolgungsausgabe angepasst werden: durch Hinzufügen von TraceListener -Instanzen hinzu oder Entfernen von Instanzen aus der Listeners Auflistung. Die Listeners Auflistung von beiden gemeinsam genutzt der Debug und der Trace Klassen; ein Ablaufverfolgungslistener zur Klasse fügt den Listener sowohl hinzufügen. Standardmäßig wird Ablaufverfolgungsausgabe ausgegeben, mit der DefaultTraceListener Klasse.

System_CAPS_noteHinweis

Hinzufügen eines Ablaufverfolgungslisteners, um die Listeners Auflistung kann dazu führen, dass eine Ausnahme während der Ablaufverfolgung, wenn eine Ressource verwendet, die vom Ablaufverfolgungslistener nicht verfügbar ist. Die Bedingung und die ausgelöste Ausnahme hängen von der Ablaufverfolgungslistener und können nicht in diesem Thema aufgelistet werden. Möglicherweise empfiehlt es sich, Aufrufe der Trace Methoden in try/catch zu erkennen und Behandeln von Ausnahmen von Ablaufverfolgungslistenern Blöcke.

System_CAPS_noteHinweis

Wenn Sie teilweise vertrauenswürdigem Code Ablaufverfolgungslistener hinzufügen, erhalten Sie eine SecurityException Ausnahme, da das Hinzufügen von Ablaufverfolgungslistenern erfordert UnmanagedCode Berechtigung. Um teilweise vertrauenswürdigem Code zu verfolgen, der in einem Sandkasten in Visual Studio ausgeführt wird, fügen Sie keine Ablaufverfolgungslistener. Stattdessen zeigen Sie die Trace und Debug Nachrichten in der Ausgabe Fenster.

Die Trace -Klasse enthält Eigenschaften zum Abrufen oder Festlegen der Ebene der Indent, IndentSize, und ob AutoFlush nach jedem Schreibvorgang.

Festlegen der AutoFlush und IndentSize für Trace, Sie können bearbeiten die Konfigurationsdatei, die den Namen der Anwendung entspricht. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert werden:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

Das ConditionalAttribute -Attribut angewendet wird, auf die Methoden des Trace. Compiler, unterstützen ConditionalAttribute ignorieren Aufrufe dieser Methoden, sofern als Symbol für die bedingte Kompilierung "TRACE" definiert ist. Finden Sie in der Dokumentation des Compilers um zu bestimmen, ob ConditionalAttribute wird unterstützt und die Syntax zum Definieren eines Symbols für die bedingte Kompilierung.

System_CAPS_noteHinweis

Klicken Sie in Visual Studio-Projekten standardmäßig Symbol für bedingte Kompilierung "DEBUG" ist für Debugbuilds definiert, und für Debugbuilds und Releasebuilds, ist das Symbol "TRACE" definiert. Informationen zum Deaktivieren dieses Verhaltens finden Sie unter Visual Studio-Dokumentation.

Symbol für bedingte Kompilierung "TRACE" in c# definieren möchten, fügen die /d:TRACE option in der Compilerbefehlszeile beim Kompilieren des Codes mithilfe einer Befehlszeile ein, oder fügen #define TRACE am Anfang der Datei. Fügen Sie in Visual Basic die /d:TRACE=True -Option in der Compilerbefehlszeile oder fügen #Const TRACE=True in die Datei.

ConditionalAttribute wird vom C++-Compiler nicht unterstützt. Um die entsprechende Funktionalität bereitzustellen, müssen Sie Aufrufe an die Methoden der einschließen Trace in ein #if defined(TRACE) ... #endif blockieren, und fügen die /DTRACE -Option in der Compilerbefehlszeile oder fügen #define TRACE in die Datei.

Im folgenden Beispiel wird Trace an den Anfang und Ende der Ausführung des Programms. Im Beispiel wird auch die Trace.Indent und Trace.Unindent Methoden, um die Ablaufverfolgungsausgabe zu unterscheiden. Ein ausführlicheres Beispiel für die Verwendung von Trace, finden Sie unter How to: Add Trace Statements to Application Code.

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main"); 
       Trace.Unindent();
    }
}

SecurityPermission

for operating with unmanaged code. Security action: F:System.Security.Permissions.SecurityAction.Demand. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

.NET Framework
Verfügbar seit 1.1

Dieser Typ ist threadsicher.

Zurück zum Anfang
Anzeigen: