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

Activity

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

ActivityListener

Umožňuje naslouchat událostem aktivity spuštění a zastavení a dává příležitost rozhodnout se o vytvoření aktivity pro scénáře vzorkování.

ActivitySource

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

ActivityTagsCollection

ActivityTagsCollection je třída kolekce sloužící k ukládání trasovacích značek.

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

Tato kolekce se chová takto:

  • Položky kolekce budou seřazeny podle toho, jak se přidají.
  • Nepovolujte duplikaci 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íči bude odebrána z kolekce.
    • Pokud má položka klíč, který dříve existoval v kolekci a hodnota není null, nahradí nová hodnota položky starou hodnotu uloženou v kolekci.
    • V opačném případě se položka přidá do kolekce.
  • Přidání metody přidá novou položku do kolekce, pokud položka ještě neexistuje se stejným klíčem. V opačném případě vyvolá výjimku.
BooleanSwitch

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

ConditionalAttribute

Označuje kompilátory, že volání metody nebo atribut by mělo být ignorováno, pokud není definován zadaný symbol podmíněné kompilace.

ConsoleTraceListener

Směruje trasování nebo ladění výstupu na standardní výstup nebo standardní datový proud chyb.

CorrelationManager

Koreluje trasování, 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ů CounterCreationData silného 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). Tuto třídu nelze zdědit.

Debugger

Umožňuje komunikaci s ladicím programem. Tuto třídu nelze zdědit.

DebuggerBrowsableAttribute

Určuje, zda a jak se člen zobrazí v oknech proměnných ladicího programu. Tuto třídu nelze zdě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 způsob zobrazení třídy nebo pole v oknech proměnných ladicího programu.

DebuggerHiddenAttribute

Určuje DebuggerHiddenAttribute. Tuto třídu nelze zdědit.

DebuggerNonUserCodeAttribute

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

DebuggerStepperBoundaryAttribute

Označuje kód, který následuje za atributem, se má spustit v režimu spuštění, nikoli kroku.

DebuggerStepThroughAttribute

Dává ladicímu programu pokyn, aby krokoval kód místo krokování do kódu. Tuto třídu nelze zdědit.

DebuggerTypeProxyAttribute

Určuje zobrazovaný proxy server pro typ.

DebuggerVisualizerAttribute

Určuje, že typ má vizualizér. Tuto třídu nelze zdědit.

DefaultTraceListener

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

DelimitedListTraceListener

Směruje trasování nebo ladění výstupu do textového zapisovače, jako je zapisovač streamu, nebo do datového proudu, jako je stream souboru.

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

poskytuje MethodBase, 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 instrumentaci kódu pro protokolování v produkčním čase bohatých datových částí pro spotřebu v rámci procesu instrumentovaného.

DistributedContextPropagator

Implementace DistributedContextPropagator určuje, jestli a jak se informace distribuovaného kontextu kódují a dekódují při procházení sítě. Kódování lze přenést přes libovolný síťový protokol, který podporuje páry klíč-hodnota řetězce. Například při použití protokolu HTTP je každý pár 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í. Tuto třídu nelze zdědit.

EventLogEntryCollection

Definuje velikost a enumerátory pro kolekci instancí EventLogEntry.

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 EventLog.

EventLogPermissionEntryCollection

Obsahuje kolekci objektů se silnými typy EventLogPermissionEntry.

EventLogTraceListener

Poskytuje jednoduchý naslouchací proces, který směruje trasování nebo ladění výstupu do 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ů InstanceData silného typu.

InstanceDataCollectionCollection

Poskytuje kolekci objektů InstanceDataCollection silného typu.

MonitoringDescriptionAttribute

Určuje popis vlastnosti nebo události.

PerformanceCounter

Představuje součást čítače výkonu systému Windows 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 pro PerformanceCounter.

PerformanceCounterPermissionEntryCollection

Obsahuje kolekci objektů se silnými typy PerformanceCounterPermissionEntry.

PresentationTraceSources

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

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.

ProcessModule

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

ProcessModuleCollection

Poskytuje kolekci objektů ProcessModule silného typu.

ProcessStartInfo

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

ProcessThread

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

ProcessThreadCollection

Poskytuje kolekci objektů ProcessThread silného typu.

SourceFilter

Určuje, jestli má naslouchací proces trasovat zprávu na základě zdroje trasování.

SourceSwitch

Poskytuje víceúrovňový přepínač pro řízení trasování a ladění výstupu bez rekompilování kódu.

StackFrame

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

StackFrameExtensions

Poskytuje rozšiřující metody pro třídu StackFrame, 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 rámců zásobníku.

StackTraceHiddenAttribute

Typy a metody s 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 vytvoř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 do TextWriter nebo do Stream, například FileStream.

Trace

Poskytuje sadu metod a vlastností, které vám pomůžou trasovat provádění kódu. Tuto třídu nelze zdědit.

TraceConfiguration

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

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

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

TraceListenerCollection

Poskytuje seznam objektů TraceListener bezpečných pro přístup z 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 ladění výstupu bez rekompilování kódu.

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í instrukce, která byla považována za nedostupnou.

XmlWriterTraceListener

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

Struktury

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ů 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.

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í

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

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

DataReceivedEventHandler

Představuje metodu, která bude zpracovávat OutputDataReceived událost nebo ErrorDataReceived událost 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

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

SampleActivity<T>

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

Poznámky

  • 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. EntryWrittenEventHandler poskytuje 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žnost určit typy protokolu událostí (které řídí typ výchozích dat, která jsou zapsána s položkou protokolu událostí) a iterovat prostřednictvím kolekcí položek protokolu událostí. Další informace o těchto úkolech naleznete v 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á aktuálně přístup k procesoru, můžete získat podrobné znalosti vláken procesu a modulů jak prostřednictvím samotné třídy Process, tak interakce s ProcessThread a ProcessModule třídy. Třída ProcessStartInfo umožňuje zadat různé prvky, se kterými se má zahájit nový proces, například vstupní, výstupní a chybové proudy, pracovní adresáře a příkazy a argumenty příkazového řádku. Díky tomu máte kontrolu nad chováním vašich procesů. Další související třídy umožňují určit styly oken, priority procesů a vláken a pracovat s kolekcemi vláken a modulů.

  • Třída PerformanceCounter umožňuje monitorovat výkon systému, zatímco třída PerformanceCounterCategory 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ém i vlastní). Můžete vzorkovat čítače pomocí třídy PerformanceCounter a vypočítat výsledky z následných ukázek čítačů výkonu pomocí CounterSample třídy. Třída CounterCreationData umožňuje vytvořit více čítačů v kategorii a určit jejich typy. Další třídy přidružené ke komponentě čítače výkonu poskytují přístup ke kolekci čítačů, oprávnění čítačů a typů čítačů.

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