System.Diagnostics-Namespace

Der System.Diagnostics-Namespace stellt Klassen bereit, die die Interaktion mit Systemprozessen, Ereignisprotokollen und Leistungsindikatoren ermöglichen.

• Die EventLog-Komponente bietet Funktionen zum Schreiben in Ereignisprotokollen, Lesen von Ereignisprotokolleinträgen und zum Erstellen und Löschen von Ereignisprotokollen und Ereignisquellen im Netzwerk. Der EntryWrittenEventHandler ermöglicht die asynchrone Interaktion mit Ereignisprotokollen. Unterstützungsklassen ermöglichen eine differenziertere Steuerung, z. B. durch Berechtigungsbeschränkungen; die Möglichkeit, Ereignisprotokolltypen anzugeben (steuert die Art der Standarddaten, die in einem Ereignisprotokolleintrag geschrieben werden) und das Durchlaufen der Auflistungen von Ereignisprotokolleinträgen. Weitere Informationen zu diesen Aufgaben finden Sie unter den Klassen EventLogPermission, EventLogEntryType und EventLogEntryCollection.

• Die Process-Klasse stellt Funktionen zum Überwachen von Systemprozessen im Netzwerk sowie zum Starten und Beenden von lokalen Systemprozessen bereit. Sie können Listen von derzeit ausgeführten Prozessen abrufen (indem Sie entweder den Computer, den Prozessnamen oder die Prozess-ID angeben), Informationen über den Prozess anzeigen, der gegenwärtig auf den Prozessor zugreift, oder über Prozessthreads und Module abrufen. Dies kann über die Process-Klasse selbst oder durch Interaktion mit der ProcessThread-Klasse und der ProcessModule-Klasse erfolgen. Mit der ProcessStartInfo-Klasse können Sie eine Vielzahl von Elementen angeben, mit denen ein neuer Prozess gestartet werden kann, z. B. Eingabe-, Ausgabe- und Fehlerstreams, Arbeitsverzeichnisse und Befehlzeilenverben und -argumente. Diese Elemente ermöglichen eine genaue Kontrolle über das Verhalten der Prozesse. Mit anderen ähnlichen Klassen können Sie Prioritäten für Fensterstile, Prozesse und Threads angeben sowie mit Auflistungen von Threads und Modulen interagieren.

• Während Sie mit der PerformanceCounter-Klasse die Systemleistung überwachen können, bietet Ihnen die PerformanceCounterCategory-Klasse die Möglichkeit, neue benutzerdefinierte Zähler und Kategorien zu erstellen. Sie können in lokal benutzerdefinierte Zähler schreiben und sowohl aus lokalen Zählern als auch aus Remotezählern (Systemzählern und benutzerdefinierte Zählern) lesen. Mit der PerformanceCounter-Klasse können Sie Zählermessungen durchführen. Die Ergebnisse von aufeinander folgenden Messungen für den Leistungsindikator können Sie mit der CounterSample-Klasse berechnen. Mit der CounterCreationData-Klasse können Sie mehrere Zähler in einer Kategorie erstellen und deren Typen angeben. Andere Klassen, die der Leistungsindikatorkomponente zugeordnet sind, bieten den Zugriff auf Zählerauflistungen, Zählerberechtigung und Zählertypen.

Der System.Diagnostics-Namespace stellt außerdem Klassen zur Verfügung, mit deren Hilfe Sie die Anwendung debuggen und die Ausführung von Code verfolgen können. Weitere Informationen finden Sie unter der Trace-Klasse und der Debug-Klasse.

Klassen

	Klasse	Beschreibung
	BooleanSwitch	Stellt einen einfachen An-Aus-Schalter bereit, der die Debugausgabe und die Ausgabe der Ablaufverfolgung steuert.
	ConditionalAttribute	Zeigt Compilern an, dass eine Methode aufgerufen werden kann, wenn auf die Methode ein angegebener Präprozessorbezeichner angewendet wird.
	ConsoleTraceListener	Leitet die Ablaufverfolgungs- oder Debugausgabe entweder in die Standardausgabe oder in den Standardfehlerstream.
	CorrelationManager	Korreliert Ablaufverfolgungen, die Teil einer logischen Transaktion sind.
	CounterCreationData	Definiert den Zählertyp, Namen und Hilfetext für einen benutzerdefinierten Zähler.
	CounterCreationDataCollection	Stellt eine stark typisierte Auflistung von CounterCreationData-Objekten bereit.
	CounterSampleCalculator	Stellt eine Reihe von Hilfsfunktionen für die Analyse der Leistungsindikatordaten bereit.
	DataReceivedEventArgs	Stellt Daten für das OutputDataReceived-Ereignis und das ErrorDataReceived-Ereignis bereit.
	Debug	Stellt eine Reihe von Methoden und Eigenschaften zum Debuggen von Code bereit. Diese Klasse kann nicht vererbt werden.
	DebuggableAttribute	Verändert die Codegenerierung für Laufzeit-JIT-Debuggen (Just-In-Time). Diese Klasse kann nicht vererbt werden.
	Debugger	Ermöglicht die Kommunikation mit einem Debugger. Diese Klasse kann nicht vererbt werden.
	DebuggerBrowsableAttribute	Bestimmt, ob und wie ein Member in den variablen Debugfenstern angezeigt wird. Diese Klasse kann nicht geerbt werden.
	DebuggerDisplayAttribute	Bestimmt, wie eine Klasse oder ein Feld in den variablen Fenstern des Debuggers angezeigt wird.
	DebuggerHiddenAttribute	Gibt das DebuggerHiddenAttribute an. Diese Klasse kann nicht vererbt werden.
	DebuggerNonUserCodeAttribute	Bezeichnet einen Typ oder einen Member, der nicht Teil des Benutzercodes einer Anwendung ist.
	DebuggerStepperBoundaryAttribute	Gibt an, dass der dem Attribut folgende Code nicht im Schrittmodus, sondern im Ausführmodus ausgeführt werden soll.
	DebuggerStepThroughAttribute	Gibt das DebuggerStepThroughAttribute an. Diese Klasse kann nicht vererbt werden.
	DebuggerTypeProxyAttribute	Gibt den Anzeigeproxy für einen Typ an.
	DebuggerVisualizerAttribute	Gibt an, dass der Typ über eine Schnellansicht verfügt. Diese Klasse kann nicht geerbt werden.
	DefaultTraceListener	Stellt die Standardausgabemethoden und das Standardverhalten für die Ablaufverfolgung bereit.
	DelimitedListTraceListener	Leitet die Ablaufverfolgungs- oder Debugausgabe an einen Textwriter, z. B. einen Streamwriter, oder in einen Stream, z. B. einen Dateistream.
	DiagnosticsConfigurationHandler	Behandelt den Diagnoseabschnitt der Konfigurationsdateien.
	EntryWrittenEventArgs	Stellt Daten für das EntryWritten-Ereignis bereit.
	EventInstance	Stellt sprachneutrale Informationen für einen Ereignisprotokolleintrag dar.
	EventLog	Ermöglicht die Interaktion mit Windows-Ereignisprotokollen.
	EventLogEntry	Kapselt einen einzigen Datensatz im Ereignisprotokoll. Diese Klasse kann nicht vererbt werden.
	EventLogEntryCollection	Definiert Größe und Enumeratoren für eine Auflistung von EventLogEntry-Instanzen.
	EventLogInstaller	Ermöglicht Ihnen das Installieren und Konfigurieren eines Ereignisprotokolls, das die Anwendung während der Ausführung liest bzw. in das sie schreibt.
	EventLogPermission	Ermöglicht das Steuern von Codezugriffsberechtigungen für die Ereignisprotokollierung.
	EventLogPermissionAttribute	Ermöglicht deklarative Berechtigungsüberprüfungen für die Ereignisprotokollierung.
	EventLogPermissionEntry	Definiert die kleinste Einheit einer Berechtigung für die Codezugriffssicherheit, die für ein EventLog festgelegt ist.
	EventLogPermissionEntryCollection	Enthält eine Auflistung von stark typisierten EventLogPermissionEntry-Objekten.
	EventLogTraceListener	Stellt einen einfachen Listener bereit, der die Ablaufverfolgungs- oder Debugausgaben an ein EventLog leitet.
	EventSourceCreationData	Stellt die Konfigurationseinstellungen dar, mit denen eine Ereignisprotokollquelle auf dem lokalen oder einem Remotecomputer erstellt wird.
	EventTypeFilter	Gibt an, ob ein Listener die Ablaufverfolgung auf Grundlage des Ereignistyps durchführen sollte.
	FileVersionInfo	Stellt Versionsinformationen für eine physikalische Datei auf einem Datenträger bereit.
	InstanceData	Enthält die einer Leitungsindikatormessung zugeordneten Instanzdaten.
	InstanceDataCollection	Stellt eine Auflistung von InstanceData-Objekten mit starker Typisierung zur Verfügung.
	InstanceDataCollectionCollection	Stellt eine stark typisierte Auflistung von InstanceDataCollection-Objekten bereit.
	MonitoringDescriptionAttribute	Gibt eine Beschreibung für eine Eigenschaft oder ein Ereignis an.
	PerformanceCounter	Stellt eine Komponente eines Windows NT-Leistungsindikators dar.
	PerformanceCounterCategory	Stellt ein Leistungsobjekt dar, das eine Kategorie von Leistungsindikatoren definiert.
	PerformanceCounterInstaller	Gibt ein Installationsprogramm für die PerformanceCounter-Komponente an.
	PerformanceCounterManager	Bereitet Leistungsdaten für die Bibliothek performance.dll vor, die beim Verwenden von Leistungsindikatoren vom System geladen wird.
	PerformanceCounterPermission	Ermöglicht das Steuern von Codezugriffsberechtigungen für PerformanceCounter.
	PerformanceCounterPermissionAttribute	Ermöglicht die deklarative Berechtigungsüberprüfungen für Leistungsindikatoren.
	PerformanceCounterPermissionEntry	Definiert die kleinste Einheit einer Berechtigung für die Codezugriffssicherheit, die für einen PerformanceCounter festgelegt ist.
	PerformanceCounterPermissionEntryCollection	Enthält eine Auflistung von stark typisierten PerformanceCounterPermissionEntry-Objekten.
	Process	Ermöglicht den Zugriff auf lokale Prozesse und Remoteprozesse und das Starten und Anhalten lokaler Systemprozesse.
	ProcessModule	Stellt eine DLL- oder EXE-Datei dar, die in einen bestimmten Prozess geladen wird.
	ProcessModuleCollection	Stellt eine Auflistung von ProcessModule-Objekten mit starker Typisierung zur Verfügung.
	ProcessStartInfo	Gibt eine Wertemenge an, die beim Starten eines Prozesses verwendet wird.
	ProcessThread	Stellt einen Prozessthread für ein Betriebssystem dar.
	ProcessThreadCollection	Stellt eine Auflistung von ProcessThread-Objekten mit starker Typisierung zur Verfügung.
	SourceFilter	Gibt an, ob ein Listener auf Grundlage der Quelle einer Ablaufverfolgung eine Meldung verfolgen soll.
	SourceSwitch	Stellt einen Schalter bereit, mit dem mehrere Ebenen ausgewählt und so Ablaufverfolgungs- und Debugausgabe gesteuert werden können, ohne dass der Code hierfür neu kompiliert werden muss.
	StackFrame	Stellt Informationen zu einem StackFrame bereit, der einen Funktionsaufruf in der Aufrufliste für den aktuellen Thread darstellt.
	StackTrace	Stellt eine Stapelüberwachung dar, d. h. eine geordnete Auflistung mindestens eines Stapelrahmens.
	Stopwatch	Stellt eine Gruppe von Methoden und Eigenschaften bereit, mit denen die verstrichene Zeit exakt gemessen werden kann.
	Switch	Stellt eine abstract-Basisklasse bereit, um neue Schalter für Debuggen und Ablaufverfolgung zu erstellen.
	SwitchAttribute	Bezeichnet einen in einer Assembly, einer Klasse oder einem Member verwendeten Schalter.
	SwitchLevelAttribute	Bezeichnet den Ebenentyp für einen Schalter.
	TextWriterTraceListener	Leitet die Ablaufverfolgungs- oder Debugausgabe an einen TextWriter oder Stream, z. B. FileStream.
	Trace	Stellt eine Reihe von Methoden und Eigenschaften bereit, mit denen Sie die Ausführung des Codes verfolgen können. Diese Klasse kann nicht vererbt werden.
	TraceEventCache	Stellt für einen Thread und einen Prozess spezifische Daten für Ablaufverfolgungsereignisse bereit.
	TraceFilter	Stellt die Basisklasse für Implementierungen von Ablaufverfolgungsfiltern bereit.
	TraceListener	Stellt die abstract-Basisklasse für die Listener bereit, die die Ablaufverfolgung und die Debugausgabe überwachen.
	TraceListenerCollection	Stellt eine threadsichere Liste von TraceListener-Objekten bereit.
	TraceSource	Stellt eine Gruppe von Methoden und Eigenschaften bereit, mit denen Anwendungen die Ausführung von Code verfolgen und Ablaufverfolgungsmeldungen ihrer jeweiligen Quelle zuordnen können.
	TraceSwitch	Stellt einen Schalter bereit, mit dem mehrere Ebenen ausgewählt und so Ablaufverfolgungs- und Debugausgabe gesteuert werden können, ohne dass der Code hierfür neu kompiliert werden muss.
	XmlWriterTraceListener	Leitet die Ablaufverfolgungs- oder Debugausgabe als XML-codierte Daten an einen TextWriter oder Stream, z. B. FileStream.

Schnittstellen

	Schnittstelle	Beschreibung
	ICollectData	Bereitet Leistungsdaten für die Bibliothek performance.dll vor, die beim Verwenden von Leistungsindikatoren vom System geladen wird.

Strukturen

	Struktur	Beschreibung
	CounterSample	Definiert eine Struktur, die die unformatierten Daten für einen Leistungsindikator enthält.

Delegaten

	Delegat	Beschreibung
	DataReceivedEventHandler	Stellt die Methode dar, die das OutputDataReceived-Ereignis oder das ErrorDataReceived-Ereignis eines Process behandelt.
	EntryWrittenEventHandler	Stellt die Methode dar, die das EntryWritten-Ereignis von EventLog behandelt.

Enumerationen

	Enumeration	Beschreibung
	DebuggableAttribute.DebuggingModes	Gibt den Debugmodus für den Just-In-Time (JIT)-Compiler an.
	DebuggerBrowsableState	Stellt Anzeigeanweisungen für den Debugger bereit.
	EventLogEntryType	Gibt den Ereignistyp eines Ereignisprotokolleintrags an.
	EventLogPermissionAccess	Definiert Zugriffsebenen, die von EventLog-Berechtigungsklassen verwendet werden.
	OverflowAction	Gibt an, wie Einträge in einem Ereignisprotokoll behandelt werden, das keine weiteren Dateien mehr aufnehmen kann.
	PerformanceCounterCategoryType	Gibt an, ob die Leistungsindikatorkategorie mehrere Instanzen haben kann.
	PerformanceCounterInstanceLifetime	Gibt die Lebensdauer einer Leistungsindikatorinstanz an.
	PerformanceCounterPermissionAccess	Definiert Zugriffsebenen, die von PerformanceCounter-Berechtigungsklassen verwendet werden.
	PerformanceCounterType	Gibt die Formel an, mit der die NextValue-Methode für eine PerformanceCounter-Instanz berechnet wird.
	ProcessPriorityClass	Gibt die Priorität an, die das System einem Prozess zuordnet. Dieser Wert bestimmt, gemeinsam mit dem Prioritätswert für jeden Thread des Prozesses, die Basisprioritätsebene jedes Threads.
	ProcessWindowStyle	Gibt an, wie ein neues Fenster angezeigt wird, wenn im System ein neuer Prozess gestartet wird.
	SourceLevels	Gibt die Ebenen der Ablaufverfolgungsmeldungen an, die vom Quellschalter und dem Ereignistypfilter gefiltert werden.
	ThreadPriorityLevel	Gibt die Prioritätsebene eines Threads an.
	ThreadState	Gibt den aktuellen Ausführungszustand des Threads an.
	ThreadWaitReason	Gibt die Ursache für den Wartezustand eines Threads an.
	TraceEventType	Bezeichnet den Typ des Ereignisses, das die Ablaufverfolgung verursacht hat.
	TraceLevel	Gibt die auszugebenden Meldungen für die Debug-Klasse, die Trace-Klasse und die TraceSwitch-Klasse an.
	TraceOptions	Gibt Optionen für Ablaufverfolgungsdaten an, die in die Ablaufverfolgungsausgabe geschrieben werden sollen.