System.Diagnostics Obor názvů

Poskytuje třídy, které umožňují interakci se systémovými procesy, protokoly událostí a čítači výkonu.

Třídy

Name Description
Activity

Představuje operaci s kontextem, která se má použít k protokolování.

ActivityListener

Umožňuje naslouchat událostem spuštění a zastavení aktivit a dává možnost rozhodovat o vytváření aktivit pro scénáře vzorkování.

ActivitySource

Poskytuje rozhraní API pro vytváření a spouštění Activity objektů a registraci ActivityListener objektů pro naslouchání událostem Activity .

ActivitySourceOptions

Možnosti pro vytvoření objektu ActivitySource.

ActivityTagsCollection

ActivityTagsCollection je kolekce používaná k ukládání tagů trasování.

Tato kolekce bude použita s třídami jako ActivityEvent a ActivityLink.

Tato kolekce se chová následovně:

  • Položky kolekce se řadí podle toho, jak se přidaly.
  • Nepovoluje se duplikování položek se stejným klíčem.
  • Při použití indexeru k uložení položky v kolekci:
    • Pokud má položka klíč, který dříve existoval v kolekci a hodnota je null, položka kolekce odpovídající klíč se z kolekce odebere.
    • Pokud má položka klíč, který dříve existoval v kolekci a hodnota není null, nahradí hodnota nové položky starou hodnotu uloženou v kolekci.
    • Jinak se položka přidá do kolekce.
  • Metoda Add do kolekce přidá novou položku, pokud ještě neexistuje položka se stejným klíčem. Jinak vyvolá výjimku.
BooleanSwitch

Poskytuje jednoduchý přepínač zapnutí/vypnutí, který ovládá výstup ladění a trasování.

ConditionalAttribute

Signalizuje kompilátorům, že mají volání metody nebo atribut ignorovat, pokud není definovaný zadaný symbol podmíněné kompilace.

ConsoleTraceListener

Směruje výstup trasování či ladění buď na standardní výstup, nebo na standardní chybový výstup.

CorrelationManager

Koreluje stopy, které jsou součástí logické transakce.

CounterCreationData

Definuje typ čítače, název a řetězec nápovědy pro vlastní čítač.

CounterCreationDataCollection

Poskytuje kolekci objektů silného CounterCreationData typu.

CounterSampleCalculator

Poskytuje sadu pomocných funkcí pro interpretaci dat čítače výkonu.

DataReceivedEventArgs

Poskytuje data pro události OutputDataReceived a ErrorDataReceived.

Debug

Poskytuje sadu metod a vlastností, které pomáhají ladit kód.

DebuggableAttribute

Upraví generování kódu pro ladění za běhu za běhu (JIT). Tato třída se nemůže dědit.

Debugger

Umožňuje komunikaci s ladicím programem. Tato třída se nemůže dědit.

DebuggerBrowsableAttribute

Určuje, jestli a jak se člen zobrazí v oknech proměnných ladicího programu. Tato třída se nemůže dědit.

DebuggerDisableUserUnhandledExceptionsAttribute

Pokud je připojen ladicí program .NET, který podporuje rozhraní API BreakForUserUnhandledException(Exception), ladicí program nezalomí neošetřené výjimky, pokud je výjimka zachycena metodou s tímto atributem, pokud není volána BreakForUserUnhandledException(Exception).

DebuggerDisplayAttribute

Určuje, jak se třída nebo pole zobrazí v oknech proměnných ladicího programu.

DebuggerHiddenAttribute

Určuje DebuggerHiddenAttribute. Tato třída se nemůže dědit.

DebuggerNonUserCodeAttribute

Označuje typ nebo člena, který není součástí uživatelského kódu aplikace.

DebuggerStepperBoundaryAttribute

Označuje, že se má kód následující za atributem spustit v režimu spuštění, a ne kroku.

DebuggerStepThroughAttribute

Určuje ladicímu programu, aby provedl krok přes kód namísto vstupu do kódu. Tato třída se nemůže dědit.

DebuggerTypeProxyAttribute

Určuje proxy zobrazení pro typ.

DebuggerVisualizerAttribute

Určuje, že typ má vizualizér. Tato třída se nemůže dědit.

DefaultTraceListener

Poskytuje výchozí metody a chování výstupu pro trasování.

DelimitedListTraceListener

Směruje výstup trasování nebo ladění do zapisovače textu, jako je zapisovač datového proudu, nebo do datového proudu, jako je filestream.

DiagnosticListener

Poskytuje implementaci abstraktní DiagnosticSource třídy, která představuje pojmenované místo, do kterého zdroj odesílá své informace (události).

DiagnosticListenerExtensions

Poskytuje třídy, které umožňují interakci se systémovými procesy, protokoly událostí a čítači výkonu.

DiagnosticMethodInfo

Představuje diagnostické informace o metodě. Informace poskytované touto třídou se podobají informacím

MethodBase poskytuje, ale je určen pro účely protokolování a trasování.

DiagnosticsConfigurationHandler

Zpracovává oddíl diagnostiky konfiguračních souborů.

DiagnosticSource

Abstraktní třída, která umožňuje instrumentovat kód pro protokolování bohatých datových struktur za běhu v produkčním prostředí, určených ke zpracování v procesu, který byl instrumentován.

DistributedContextPropagator

Implementace určuje, jestli a jak se informace distribuovaného DistributedContextPropagator kontextu kódují a dekódují při procházení sítě. Kódování je možné přenášet přes jakýkoli síťový protokol, který podporuje řetězcové páry klíč-hodnota. Při použití protokolu HTTP je například každá dvojice klíč–hodnota hlavičkou HTTP. DistributedContextPropagator vloží hodnoty do operátorů a extrahuje je z operátorů jako párů klíč-hodnota řetězce.

EntryWrittenEventArgs

Poskytuje data pro událost EntryWritten.

EventInstance

Představuje jazykově neutrální informace pro položku protokolu událostí.

EventLog

Poskytuje interakci s protokoly událostí Systému Windows.

EventLogEntry

Zapouzdřuje jeden záznam v protokolu událostí. Tato třída se nemůže dědit.

EventLogEntryCollection

Definuje velikost a výčty pro kolekci EventLogEntry instancí.

EventLogInstaller

Umožňuje nainstalovat a nakonfigurovat protokol událostí, ze kterého vaše aplikace při spuštění načítá nebo zapisuje.

EventLogPermission

Řídí přístupová oprávnění kódu pro protokolování událostí.

EventLogPermissionAttribute

Umožňuje deklarativní kontroly oprávnění pro protokolování událostí.

EventLogPermissionEntry

Definuje nejmenší jednotku oprávnění zabezpečení přístupu kódu, která je nastavena pro objekt EventLog.

EventLogPermissionEntryCollection

Obsahuje kolekci objektů silného EventLogPermissionEntry typu.

EventLogTraceListener

Poskytuje jednoduchý naslouchací proces, který směruje trasování nebo ladění výstupu na .EventLog

EventSchemaTraceListener

Směruje trasování nebo ladění výstupu komplexních událostí do souboru protokolu kompatibilního se schématem XML.

EventSourceCreationData

Představuje nastavení konfigurace použité k vytvoření zdroje protokolu událostí v místním počítači nebo vzdáleném počítači.

EventTypeFilter

Určuje, jestli má naslouchací proces trasovat na základě typu události.

FileVersionInfo

Poskytuje informace o verzi fyzického souboru na disku.

InitializingSwitchEventArgs

Poskytuje data pro událost Switch.Initializing .

InitializingTraceSourceEventArgs

Poskytuje data pro událost TraceSource.Initializing .

InstanceData

Uchovává data instance přidružená k ukázce čítače výkonu.

InstanceDataCollection

Poskytuje kolekci objektů silného InstanceData typu.

InstanceDataCollectionCollection

Poskytuje kolekci objektů silného InstanceDataCollection typu.

MonitoringDescriptionAttribute

Určuje popis vlastnosti nebo události.

PerformanceCounter

Představuje Windows komponentu čítače výkonu NT.

PerformanceCounterCategory

Představuje objekt výkonu, který definuje kategorii čítačů výkonu.

PerformanceCounterInstaller

Určuje instalační program pro komponentu PerformanceCounter .

PerformanceCounterManager

Připraví údaje o výkonu pro performance.dll zatížení systému při práci s čítači výkonu.

PerformanceCounterPermission

Umožňuje řídit přístupová oprávnění kódu pro PerformanceCounter.

PerformanceCounterPermissionAttribute

Umožňuje kontroly oprávnění čítače deklarativního výkonu.

PerformanceCounterPermissionEntry

Definuje nejmenší jednotku oprávnění zabezpečení přístupu kódu, která je nastavena PerformanceCounterpro .

PerformanceCounterPermissionEntryCollection

Obsahuje kolekci objektů silného PerformanceCounterPermissionEntry typu.

PresentationTraceSources

Poskytuje podporu trasování ladění, která je určena speciálně pro aplikace Windows Presentation Foundation (WPF (Windows Presentation Foundation)).

Process

Poskytuje přístup k místním a vzdáleným procesům a umožňuje spouštět a zastavovat místní systémové procesy.

ProcessExitStatus

Poskytuje třídy, které umožňují interakci se systémovými procesy, protokoly událostí a čítači výkonu.

ProcessModule

Představuje soubor .dll nebo .exe, který se načte do konkrétního procesu.

ProcessModuleCollection

Poskytuje kolekci objektů silného ProcessModule typu.

ProcessStartInfo

Určuje sadu hodnot, které se použijí při spuštění procesu.

ProcessTextOutput

Poskytuje třídy, které umožňují interakci se systémovými procesy, protokoly událostí a čítači výkonu.

ProcessThread

Představuje vlákno procesu operačního systému.

ProcessThreadCollection

Poskytuje kolekci objektů silného ProcessThread typu.

SourceFilter

Určuje, zda má posluchač trasovat zprávu na základě zdroje trasování.

SourceSwitch

Poskytuje víceúrovňový přepínač pro řízení trasování a ladicích výstupů bez nutnosti znovu kompilovat kód.

StackFrame

Poskytuje informace o , StackFramekterý představuje volání funkce zásobník volání pro aktuální vlákno.

StackFrameExtensions

Poskytuje rozšiřující metody pro StackFrame třídu, která představuje volání funkce zásobník volání pro aktuální vlákno.

StackTrace

Představuje trasování zásobníku, což je uspořádaná kolekce jednoho nebo více bloků zásobníku.

StackTraceHiddenAttribute

Typy a metody označené atributem StackTraceHidden budou vynechány z textu trasování zásobníku zobrazeného v StackTrace.ToString() a Exception.StackTrace.

Stopwatch

Poskytuje sadu metod a vlastností, které můžete použít k přesnému měření uplynulého času.

Switch

Poskytuje abstraktní základní třídu pro vytváření nových přepínačů ladění a trasování.

SwitchAttribute

Identifikuje přepínač použitý v sestavení, třídě nebo členu.

SwitchLevelAttribute

Určuje typ úrovně přepínače.

TextWriterTraceListener

Směruje trasování nebo ladění výstupu TextWriter do nebo do , Streamnapříklad FileStream.

Trace

Poskytuje sadu metod a vlastností, které pomáhají trasovat provádění kódu. Tato třída se nemůže dědit.

TraceConfiguration

Poskytuje metody pro registraci a konfiguraci nastavení trasování z konfiguračních souborů do TraceSource souvisejících tříd.

TraceEventCache

Poskytuje data událostí trasování specifická pro vlákno a proces.

TraceFilter

Poskytuje základní třídu pro implementace filtru trasování.

TraceListener

abstract Poskytuje základní třídu pro naslouchací procesy, kteří monitorují trasování a ladění výstupu.

TraceListenerCollection

Poskytuje seznam objektů bezpečných pro přístup z TraceListener více vláken.

TraceSource

Poskytuje sadu metod a vlastností, které aplikacím umožňují sledovat provádění kódu a přidružit trasovací zprávy ke zdroji.

TraceSwitch

Poskytuje víceúrovňový přepínač pro řízení trasování a ladicích výstupů bez nutnosti znovu kompilovat kód.

UnescapedXmlDiagnosticData

Poskytuje neuskutečené data XML pro protokolování trasovacích dat zadaných uživatelem.

UnreachableException

Výjimka, která se vyvolá, když program spustí instrukci, která se považovala za nedostupnou.

XmlWriterTraceListener

Směruje trasování nebo ladění výstupu jako xml kódovaná data do TextWriter nebo do Stream, jako FileStreamje například .

Struktury

Name Description
Activity.Enumerator<T>

Vytvoří výčet dat uložených v objektu Activity.

ActivityChangedEventArgs

Poskytuje data pro událost CurrentChanged.

ActivityContext

Reprezentace, která odpovídá specifikaci W3C TraceContext. Obsahuje dva identifikátory: TraceId a SpanId spolu se sadou běžných hodnot TraceFlags a TraceState specifických pro systém.

ActivityCreationOptions<T>

Zapouzdřuje všechny informace, které se odesílají naslouchacímu procesu aktivity, aby se mohli rozhodovat o vytvoření instance aktivity a jeho stavu.

Možné parametry obecného typu jsou ActivityContext nebo String.

ActivityEvent

Představuje událost obsahující název a časové razítko a volitelný seznam značek.

ActivityLink

Aktivity můžou být propojeny s nulovými nebo více instancemi kontextu aktivity, které jsou kauzálně související.

Odkazy na aktivity můžou odkazovat na kontexty aktivity uvnitř jednoho trasování nebo napříč různými trasami.

Odkazy na aktivity lze použít k reprezentaci dávkových operací, kdy byla aktivita inicializována několika iniciačními aktivitami, z nichž každá představuje jednu příchozí položku zpracovávanou v dávce.

ActivitySpanId

Představuje SpanId formátovaný na základě standardu W3C.

ActivityTagsCollection.Enumerator

Vytvoří výčet prvků objektu ActivityTagsCollection.

ActivityTraceId

Představuje TraceId, jehož formát je založen na standardu W3C.

CounterSample

Definuje strukturu, která obsahuje nezpracovaná data pro čítač výkonu.

Debug.AssertInterpolatedStringHandler

Poskytuje interpolovanou obslužnou rutinu řetězce pro Assert(Boolean), která provádí formátování pouze v případě, že se assert nezdaří.

Debug.WriteIfInterpolatedStringHandler

Poskytuje interpolovanou obslužnou rutinu řetězce pro WriteIf(Boolean, String) a WriteLineIf(Boolean, Object), která provádí formátování pouze v případě použití podmínky.

ProcessOutputLine

Poskytuje třídy, které umožňují interakci se systémovými procesy, protokoly událostí a čítači výkonu.

TagList

Představuje seznam značek, ke kterým má index přístup. Poskytuje metody pro vyhledávání, řazení a manipulaci se seznamy.

TagList.Enumerator

Enumerátor pro procházení kolekce seznamů značek.

Rozhraní

Name Description
ICollectData

Připraví údaje o výkonu pro knihovnu DLL výkonu, které systém načte při práci s čítači výkonu.

Výčty

Name Description
ActivityIdFormat

Určuje formát vlastnosti Id.

ActivityKind

Popisuje vztah mezi aktivitou, jejími rodiči a jeho podřízenými objekty v trasování.

ActivitySamplingResult

Hodnoty výčtu používané ActivityListener označující množství dat, která se mají shromáždit pro související Activity. Vyžádání dalších dat způsobuje vyšší režii na výkon.

ActivityStatusCode

Definujte stavový kód aktivity, který označuje stav instrumentované operace.

ActivityTraceFlags

Určuje příznaky definované standardem W3C, které jsou přidružené k aktivitě.

DebuggableAttribute.DebuggingModes

Určuje režim ladění pro kompilátor JIT (just-in-time).

DebuggerBrowsableState

Poskytuje pokyny pro zobrazení ladicího programu.

EventLogEntryType

Určuje typ události položky protokolu událostí.

EventLogPermissionAccess

Definuje úrovně přístupu používané EventLog třídami oprávnění.

OverflowAction

Určuje, jak zpracovat položky v protokolu událostí, který dosáhl maximální velikosti souboru.

PerformanceCounterCategoryType

Určuje, zda kategorie čítače výkonu může mít více instancí.

PerformanceCounterInstanceLifetime

Určuje životnost instance čítače výkonu.

PerformanceCounterPermissionAccess

Definuje úrovně přístupu používané PerformanceCounter třídami oprávnění.

PerformanceCounterType

Určuje typy čítačů výkonu, které se mapuje přímo na nativní typy.

PresentationTraceLevel

Popisuje úroveň podrobností pro trasování určitého objektu.

ProcessPriorityClass

Určuje prioritu, kterou systém přidruží k procesu. Tato hodnota společně s hodnotou priority každého vlákna procesu určuje základní úroveň priority jednotlivých vláken.

ProcessWindowStyle

Určuje, jak se má při spuštění procesu zobrazit nové okno.

SourceLevels

Určuje úrovně trasovacích zpráv filtrovaných filtrem zdrojového přepínače a typu události.

ThreadPriorityLevel

Určuje úroveň priority vlákna.

ThreadState

Určuje aktuální stav spuštění vlákna.

ThreadWaitReason

Určuje důvod, proč vlákno čeká.

TraceEventType

Identifikuje typ události, která způsobila trasování.

TraceLevel

Určuje, jaké zprávy mají být výstupem pro třídy Debug, Trace a TraceSwitch.

TraceLogRetentionOption

Určuje strukturu souborů, která se použije pro protokol EventSchemaTraceListener.

TraceOptions

Určuje možnosti trasování dat, které se mají zapisovat do výstupu trasování.

Delegáti

Name Description
DataReceivedEventHandler

Představuje metodu, která bude zpracovávat OutputDataReceived událost nebo ErrorDataReceived událost objektu Process.

DistributedContextPropagator.PropagatorGetterCallback

Představuje metodu zpětného volání, která se používá v metodách extrakce šíření. Zpětné volání se vyvolá, aby vyhledávala hodnotu pojmenovaného pole.

DistributedContextPropagator.PropagatorSetterCallback

Představuje metodu zpětného volání, která se používá v metodách injektáže šíření. Toto zpětné volání se vyvolá za účelem nastavení hodnoty pojmenovaného pole. Šíření ho mohou vyvolat vícekrát, aby bylo možné nastavit více polí.

EntryWrittenEventHandler

Představuje metodu, která bude zpracovávat EntryWritten událost .EventLog

ExceptionRecorder

Definuje zpětné volání, které ActivityListener se má použít k příjmu oznámení při přidání výjimek do Activity.

SampleActivity<T>

Delegát, který definuje podpis zpětných ActivityListener volání použitých v procesu vzorkování.

Poznámky

  • Tato komponenta EventLog poskytuje funkce pro zápis do protokolů událostí, čtení položek protokolu událostí a vytváření a odstraňování protokolů událostí a zdrojů událostí v síti. Poskytuje EntryWrittenEventHandler způsob, jak asynchronně pracovat s protokoly událostí. Podpůrné třídy poskytují přístup k podrobnějšímu řízení, včetně omezení oprávnění, možnosti zadat typy protokolů událostí (čímž se řídí typ výchozích dat, která se zapisují se záznamem protokolu událostí) a možnosti iterovat kolekcemi záznamů protokolů událostí. Další informace o těchto úkolech naleznete v tématu EventLogPermission, EventLogEntryTypea EventLogEntryCollection třídy.

  • Třída Process poskytuje funkce pro monitorování systémových procesů v síti a spouštění a zastavení místních systémových procesů. Kromě načítání seznamů spuštěných procesů (určením počítače, názvu procesu nebo ID procesu) nebo zobrazením informací o procesu, který má přístup k procesoru, můžete získat podrobné znalosti vláken procesů a modulů jak prostřednictvím Process samotné třídy, tak interakce s těmito ProcessThread třídami.ProcessModule Třída ProcessStartInfo umožňuje zadat řadu prvků, pomocí kterých lze zahájit nový proces, jako jsou vstupní, výstupní a chybové proudy, pracovní adresáře a příkazy a argumenty příkazového řádku. Díky tomu můžete podrobně řídit chování procesů. Další související třídy umožňují zadat styly oken nebo priority procesů a vláken a pracovat s kolekcemi vláken a modulů.

  • Tato PerformanceCounter třída umožňuje monitorovat výkon systému, zatímco PerformanceCounterCategory třída poskytuje způsob, jak vytvořit nové vlastní čítače a kategorie. Můžete zapisovat do místních vlastních čítačů a číst z místních i vzdálených čítačů (systémových i vlastních). Pomocí třídy můžete vzorkovat čítače PerformanceCounter a vypočítat výsledky z následných ukázek čítačů výkonu CounterSample pomocí třídy. Třída CounterCreationData umožňuje vytvořit více čítačů v kategorii a zadat jejich typy. Další třídy spojené s komponentou čítačů výkonu poskytují přístup ke kolekcím čítačů, oprávněním čítačů a typům čítačů.

Obor System.Diagnostics názvů také poskytuje třídy, které umožňují ladit aplikaci a sledovat provádění kódu. Další informace najdete ve třídách Trace a Debug.