System.Diagnostics Obor názvů
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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ě:
|
| 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 |
|
| 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 |
| 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.