System.Diagnostics Namespace

Stellt Klassen bereit, mit denen Sie mit Systemprozessen, Ereignisprotokollen und Leistungsindikatoren interagieren können.

Klassen

Activity	Stellt einen Vorgang mit Kontext dar, der für die Protokollierung verwendet werden soll.
ActivityListener	Ermöglicht das Überwachen der Start- und Stoppaktivitätsereignisse und bietet die Möglichkeit, eine Aktivität für Samplingszenarien zu erstellen.
ActivitySource	Stellt APIs bereit, um Activity Objekte zu erstellen und zu starten und ActivityListener Objekte zu registrieren, um auf die Activity Ereignisse zu lauschen.
ActivityTagsCollection	ActivityTagsCollection ist eine Sammlungsklasse, die zum Speichern von Ablaufverfolgungstags verwendet wird. Diese Auflistung wird mit Klassen wie ActivityEvent und ActivityLinkverwendet. Diese Auflistung verhält sich wie folgt: Die Sammlungselemente werden entsprechend der Hinzugefügten sortiert. Duplizierung von Elementen mit demselben Schlüssel nicht zulassen. Beim Verwenden des Indexers zum Speichern eines Elements in der Auflistung: Wenn das Element über einen Schlüssel verfügt, der zuvor in der Auflistung vorhanden ist und der Wert nullist, wird das Sammlungselement, das dem Schlüssel entspricht, aus der Auflistung entfernt. Wenn das Element über einen Schlüssel verfügt, der zuvor in der Auflistung vorhanden war und der Wert nicht nullist, ersetzt der neue Elementwert den alten Wert, der in der Auflistung gespeichert ist. Andernfalls wird das Element der Auflistung hinzugefügt. Die Add-Methode fügt der Auflistung ein neues Element hinzu, wenn ein Element noch nicht mit demselben Schlüssel vorhanden ist. Andernfalls wird eine Ausnahme ausgelöst.
BooleanSwitch	Stellt einen einfachen Ein/Aus-Schalter bereit, der das Debuggen und die Ablaufverfolgungsausgabe steuert.
ConditionalAttribute	Gibt an, dass ein Methodenaufruf oder -attribut ignoriert werden soll, es sei denn, ein angegebenes Symbol für die bedingte Kompilierung ist definiert.
ConsoleTraceListener	Leitet die Ablaufverfolgung oder das Debuggen der Ausgabe an die Standardausgabe oder den Standardfehlerdatenstrom weiter.
CorrelationManager	Korreliert Ablaufverfolgungen, die Teil einer logischen Transaktion sind.
DataReceivedEventArgs	Stellt Daten für die ereignisse OutputDataReceived und ErrorDataReceived bereit.
Debug	Stellt eine Reihe von Methoden und Eigenschaften bereit, die beim Debuggen des Codes helfen.
DebuggableAttribute	Ändert die Codegenerierung für das Just-in-Time-Debugging (Just-in-Time) der Laufzeit. Diese Klasse kann nicht geerbt werden.
Debugger	Ermöglicht die Kommunikation mit einem Debugger. Diese Klasse kann nicht geerbt werden.
DebuggerBrowsableAttribute	Bestimmt, ob und wie ein Element in den Fenstern der Debuggervariablen angezeigt wird. Diese Klasse kann nicht geerbt werden.
DebuggerDisplayAttribute	Bestimmt, wie eine Klasse oder ein Feld in den Fenstern der Debuggervariablen angezeigt wird.
DebuggerHiddenAttribute	Gibt die DebuggerHiddenAttributean. Diese Klasse kann nicht geerbt werden.
DebuggerNonUserCodeAttribute	Gibt einen Typ oder ein Element an, der nicht Teil des Benutzercodes für eine Anwendung ist.
DebuggerStepperBoundaryAttribute	Gibt an, dass der Code, der dem Attribut folgt, im Ausführungsmodus ausgeführt werden soll, nicht im Schrittmodus.
DebuggerStepThroughAttribute	Weist den Debugger an, den Code zu durchlaufen, anstatt in den Code zu wechseln. Diese Klasse kann nicht geerbt werden.
DebuggerTypeProxyAttribute	Gibt den Anzeigeproxy für einen Typ an.
DebuggerVisualizerAttribute	Gibt an, dass der Typ über eine Visualisierung verfügt. Diese Klasse kann nicht geerbt werden.
DefaultTraceListener	Stellt die Standardausgabemethoden und das Verhalten für die Ablaufverfolgung bereit.
DelimitedListTraceListener	Leitet die Ablaufverfolgung oder das Debuggen der Ausgabe an einen Textschreiber, z. B. einen Stream writer, oder an einen Stream, z. B. einen Dateidatenstrom.
DiagnosticListener	Stellt eine Implementierung der abstrakten DiagnosticSource Klasse bereit, die einen benannten Ort darstellt, an den eine Quelle seine Informationen (Ereignisse) sendet.
DiagnosticSource	Eine abstrakte Klasse, mit der Code für die Produktionszeitprotokollierung von umfangreichen Datennutzlasten für den Verbrauch innerhalb des prozesses instrumentiert werden kann.
DistributedContextPropagator	Eine Implementierung von DistributedContextPropagator bestimmt, ob und wie verteilte Kontextinformationen codiert und decodiert werden, während es das Netzwerk durchläuft. Die Codierung kann über jedes Netzwerkprotokoll transportiert werden, das Zeichenfolgen-Schlüsselwert-Paare unterstützt. Bei Verwendung von HTTP ist jedes Schlüsselwertpaar beispielsweise ein HTTP-Header. DistributedContextPropagator Werte in Zeichenfolgenschlüssel-Wert-Paare injizieren und werte aus Zeichenfolgen-Schlüsselwertpaaren extrahieren.
EventTypeFilter	Gibt an, ob ein Listener basierend auf dem Ereignistyp ablaufen soll.
FileVersionInfo	Stellt Versionsinformationen für eine physische Datei auf dem Datenträger bereit.
InitializingSwitchEventArgs	Stellt Daten für das Switch.Initializing-Ereignis bereit.
InitializingTraceSourceEventArgs	Stellt Daten für das TraceSource.Initializing-Ereignis bereit.
MonitoringDescriptionAttribute	Gibt eine Beschreibung für eine Eigenschaft oder ein Ereignis an.
Process	Bietet Zugriff auf lokale und Remoteprozesse und ermöglicht es Ihnen, lokale Systemprozesse zu starten und zu beenden.
ProcessModule	Stellt eine .dll oder .exe Datei dar, die in einen bestimmten Prozess geladen wird.
ProcessModuleCollection	Stellt eine stark typierte Auflistung von ProcessModule -Objekten bereit.
ProcessStartInfo	Gibt eine Gruppe von Werten an, die beim Starten eines Prozesses verwendet werden.
ProcessThread	Stellt einen Prozessthread des Betriebssystems dar.
ProcessThreadCollection	Stellt eine stark typierte Auflistung von ProcessThread -Objekten bereit.
SourceFilter	Gibt an, ob ein Listener eine Nachricht basierend auf der Quelle einer Ablaufverfolgung nachverfolgen soll.
SourceSwitch	Stellt einen mehrstufigen Switch bereit, um die Ablaufverfolgung zu steuern und die Ausgabe zu debuggen, ohne den Code neu zu kompilieren.
StackFrame	Stellt Informationen zu einer StackFramebereit, die einen Funktionsaufruf im Aufrufstapel für den aktuellen Thread darstellt.
StackFrameExtensions	Stellt Erweiterungsmethoden für die StackFrame-Klasse bereit, die einen Funktionsaufruf im Aufrufstapel für den aktuellen Thread darstellt.
StackTrace	Stellt eine Stapelablaufverfolgung dar, bei der es sich um eine sortierte Auflistung eines oder mehrerer Stapelframes handelt.
StackTraceHiddenAttribute	Typen und Methoden, die StackTraceHidden zugeordnet sind, werden aus dem Stapelablaufverfolgungstext ausgelassen, der in StackTrace.ToString() und Exception.StackTrace angezeigt wird.
Stopwatch	Stellt eine Reihe von Methoden und Eigenschaften bereit, mit denen Sie die verstrichene Zeit genau messen können.
Switch	Stellt eine abstrakte Basisklasse zum Erstellen neuer Debug- und Ablaufverfolgungsoptionen bereit.
SwitchAttribute	Identifiziert einen Schalter, der in einer Assembly, Klasse oder einem Element verwendet wird.
SwitchLevelAttribute	Gibt den Ebenentyp für einen Schalter an.
TextWriterTraceListener	Leitet die Ablaufverfolgung oder das Debuggen der Ausgabe an eine TextWriter oder an eine Stream, z. B. FileStream.
Trace	Stellt eine Reihe von Methoden und Eigenschaften bereit, mit denen Sie die Ausführung des Codes nachverfolgen können. Diese Klasse kann nicht geerbt werden.
TraceEventCache	Stellt Ablaufverfolgungsereignisdaten bereit, die für einen Thread und einen Prozess spezifisch sind.
TraceFilter	Stellt die Basisklasse für Ablaufverfolgungsfilterimplementierungen bereit.
TraceListener	Stellt die abstract Basisklasse für die Listener bereit, die die Ablaufverfolgung überwachen und die Ausgabe debuggen.
TraceListenerCollection	Stellt eine threadsichere Liste von TraceListener Objekten bereit.
TraceSource	Stellt eine Reihe von Methoden und Eigenschaften bereit, mit denen Anwendungen die Ausführung von Code nachverfolgen und Ablaufverfolgungsmeldungen ihrer Quelle zuordnen können.
TraceSwitch	Stellt einen mehrstufigen Switch bereit, um die Ablaufverfolgung zu steuern und die Ausgabe zu debuggen, ohne den Code neu zu kompilieren.
UnreachableException	Die Ausnahme, die ausgelöst wird, wenn das Programm eine Anweisung ausführt, die als nicht erreichbar betrachtet wurde.
XmlWriterTraceListener	Directs tracing or debugging output as XML-encoded data to a TextWriter or to a Stream, such as a FileStream.

Strukturen

Activity.Enumerator<T>	Listet die daten auf, die in einem Activity-Objekt gespeichert sind.
ActivityChangedEventArgs	Stellt Daten für das CurrentChanged-Ereignis bereit.
ActivityContext	Eine Darstellung, die der W3C TraceContext-Spezifikation entspricht. Es enthält zwei Bezeichner: eine TraceId und eine SpanId sowie eine Reihe allgemeiner TraceFlags- und systemspezifischer TraceState-Werte.
ActivityCreationOptions<T>	Kapselt alle Informationen, die an den Aktivitätslistener gesendet werden, um Entscheidungen zur Erstellung der Aktivitätsinstanz sowie zum Zustand zu treffen. Die möglichen generischen Typparameter sind ActivityContext oder String.
ActivityEvent	Stellt ein Ereignis dar, das einen Namen und einen Zeitstempel sowie eine optionale Liste von Tags enthält.
ActivityLink	Aktivitäten können mit Null- oder mehr Aktivitätskontextinstanzen verknüpft werden, die kausal miteinander verknüpft sind. Aktivitätslinks können auf Aktivitätskontexte innerhalb einer einzelnen Ablaufverfolgung oder über verschiedene Ablaufverfolgungen verweisen. Aktivitätslinks können verwendet werden, um Batchvorgänge darzustellen, bei denen eine Aktivität durch mehrere initiierende Aktivitäten initiiert wurde, wobei jeweils ein einzelnes eingehendes Element im Batch verarbeitet wird.
ActivitySpanId	Stellt ein auf einem W3C-Standard formatiertes SpanId dar.
ActivityTagsCollection.Enumerator	Listet die Elemente eines ActivityTagsCollectionauf.
ActivityTraceId	Stellt eine TraceId dar, deren Format auf einem W3C-Standard basiert.
Debug.AssertInterpolatedStringHandler	Stellt einen interpolierten Zeichenfolgenhandler für Assert(Boolean) bereit, der nur Formatierungen ausführt, wenn die Assertion fehlschlägt.
Debug.WriteIfInterpolatedStringHandler	Stellt einen interpolierten Zeichenfolgenhandler für WriteIf(Boolean, String) und WriteLineIf(Boolean, Object) bereit, der nur Formatierungen ausführt, wenn die Bedingung gilt.
TagList	Stellt eine Liste von Tags dar, auf die nach Index zugegriffen werden kann. Stellt Methoden zum Durchsuchen, Sortieren und Bearbeiten von Listen bereit.
TagList.Enumerator	Ein Enumerator zum Durchlaufen einer Taglistenauflistung.

Enumerationen

ActivityIdFormat	Gibt das Format der Id-Eigenschaft an.
ActivityKind	Beschreibt die Beziehung zwischen der Aktivität, ihren Eltern und ihren Kindern in einer Spur.
ActivitySamplingResult	Enumerationswerte, die von ActivityListener verwendet werden, um die Datenmenge anzugeben, die für die zugehörigen Activityerfasst werden soll. Das Anfordern weiterer Daten führt zu einem höheren Leistungsaufwand.
ActivityStatusCode	Definieren Sie den Statuscode der Aktivität, der den Status des instrumentierten Vorgangs angibt.
ActivityTraceFlags	Gibt Flags an, die durch den W3C-Standard definiert sind, die einer Aktivität zugeordnet sind.
DebuggableAttribute.DebuggingModes	Gibt den Debugmodus für den Just-in-Time-Compiler (JIT) an.
DebuggerBrowsableState	Enthält Anzeigeanweisungen für den Debugger.
ProcessPriorityClass	Gibt die Priorität an, die das System einem Prozess zuordnet. Dieser Wert bestimmt zusammen mit dem Prioritätswert jedes Threads des Prozesses die Basisprioritätsebene jedes Threads.
ProcessWindowStyle	Gibt an, wie ein neues Fenster angezeigt werden soll, wenn das System einen Prozess startet.
SourceLevels	Gibt die Ebenen von Ablaufverfolgungsmeldungen an, die nach dem Quellswitch- und Ereignistypfilter gefiltert werden.
ThreadPriorityLevel	Gibt die Prioritätsebene eines Threads an.
ThreadState	Gibt den aktuellen Ausführungsstatus des Threads an.
ThreadWaitReason	Gibt den Grund an, warum ein Thread wartet.
TraceEventType	Gibt den Ereignistyp an, der die Ablaufverfolgung verursacht hat.
TraceLevel	Gibt an, welche Nachrichten für die klassen Debug, Trace und TraceSwitch ausgegeben werden sollen.
TraceOptions	Gibt Ablaufverfolgungsdatenoptionen an, die in die Ablaufverfolgungsausgabe geschrieben werden sollen.

Delegaten

DataReceivedEventHandler	Stellt die Methode dar, die das OutputDataReceived Ereignis oder ErrorDataReceived Ereignis eines Processbehandelt.
DistributedContextPropagator.PropagatorGetterCallback	Stellt die Rückrufmethode dar, die in den Extraktmethoden von Verteilungsmodulen verwendet wird. Der Rückruf wird aufgerufen, um den Wert eines benannten Felds nachzuschlagen.
DistributedContextPropagator.PropagatorSetterCallback	Stellt die Rückrufmethode dar, die in den injizierten Methoden der Verteilungsmodule verwendet wird. Dieser Rückruf wird aufgerufen, um den Wert eines benannten Felds festzulegen. Verteilungsmodule können sie mehrmals aufrufen, um mehrere Felder festzulegen.
SampleActivity<T>	Ein Delegat, der die Signatur der im Samplingprozess verwendeten ActivityListener Rückrufe definiert.

Hinweise

• Die EventLog-Komponente bietet Funktionen zum Schreiben in Ereignisprotokolle, Lesen von Ereignisprotokolleinträgen und Erstellen und Löschen von Ereignisprotokollen und Ereignisquellen im Netzwerk. Die EntryWrittenEventHandler bietet eine Möglichkeit, asynchron mit Ereignisprotokollen zu interagieren. Unterstützungsklassen ermöglichen den Zugriff auf eine detailliertere Kontrolle, einschließlich: Berechtigungseinschränkungen, die Möglichkeit, Ereignisprotokolltypen anzugeben (die den Typ der Standarddaten steuert, die mit einem Ereignisprotokolleintrag geschrieben werden), und durchlaufen Auflistungen von Ereignisprotokolleinträgen. Weitere Informationen zu diesen Aufgaben finden Sie in den Klassen EventLogPermission, EventLogEntryTypeund EventLogEntryCollection.

• Die Process-Klasse bietet Funktionen zum Überwachen von Systemprozessen im gesamten Netzwerk und zum Starten und Beenden lokaler Systemprozesse. Zusätzlich zum Abrufen von Listen der ausgeführten Prozesse (durch Angeben des Computers, des Prozessnamens oder der Prozess-ID) oder anzeigen von Informationen über den Prozess, der derzeit Zugriff auf den Prozessor hat, können Sie detaillierte Kenntnisse über Prozessthreads und Module sowohl über die Process Klasse selbst abrufen als auch mit den ProcessThread und ProcessModule Klassen interagieren. Mit der ProcessStartInfo-Klasse können Sie eine Vielzahl von Elementen angeben, mit denen ein neuer Prozess gestartet werden soll, z. B. Eingabe-, Ausgabe- und Fehlerdatenströme, Arbeitsverzeichnisse und Befehlszeilenverben und Argumente. Diese bieten Ihnen eine gute Kontrolle über das Verhalten Ihrer Prozesse. Mit anderen verwandten Klassen können Sie Fensterstile, Prozess- und Threadprioritäten angeben und mit Sammlungen von Threads und Modulen interagieren.

• Mit der PerformanceCounter-Klasse können Sie die Systemleistung überwachen, während die PerformanceCounterCategory Klasse eine Möglichkeit zum Erstellen neuer benutzerdefinierter Leistungsindikatoren und Kategorien bietet. Sie können in lokale benutzerdefinierte Leistungsindikatoren schreiben und sowohl von lokalen als auch von Remotezählern (System und benutzerdefiniert) lesen. Sie können Leistungsindikatoren mithilfe der PerformanceCounter-Klasse beispielen und Ergebnisse aus aufeinander folgenden Leistungsindikatorbeispielen mithilfe der CounterSample-Klasse berechnen. Mit der CounterCreationData-Klasse können Sie mehrere Leistungsindikatoren in einer Kategorie erstellen und deren Typen angeben. Andere Klassen, die der Leistungsindikatorkomponente zugeordnet sind, bieten Zugriff auf Sammlungen von Leistungsindikatoren, Zählerberechtigungen und Leistungsindikatorentypen.

Der System.Diagnostics-Namespace stellt außerdem Klassen bereit, mit denen Sie Ihre Anwendung debuggen und die Ausführung des Codes nachverfolgen können. Weitere Informationen finden Sie in den Klassen Trace und Debug.