System.Diagnostics Névtér

Olyan osztályokat biztosít, amelyek lehetővé teszik a rendszerfolyamatok, az eseménynaplók és a teljesítményszámlálók használatát.

Osztályok

Name Description
Activity

A naplózáshoz használt kontextussal rendelkező műveletet reprezentálja.

ActivityListener

Lehetővé teszi az indítási és leállítási tevékenységesemények figyelését, és lehetőséget nyújt annak eldöntésére, létrehoz-e egy tevékenységet mintavételezési forgatókönyvekhez.

ActivitySource

API-kat biztosít objektumok létrehozásához és elindításához Activity , valamint objektumok regisztrálásához ActivityListener az Activity események figyeléséhez.

ActivitySourceOptions

Beállítások a létrehozáshoz ActivitySource.

ActivityTagsCollection

Az ActivityTagsCollection egy nyomkövető címkék tárolására szolgáló gyűjteményosztály.

Ez a gyűjtemény olyan osztályokhoz lesz használva, mint ActivityEvent és ActivityLink.

Ez a gyűjtemény az alábbiak szerint működik:

  • A gyűjtemény elemei a hozzáadásuk módja szerint lesznek rendezve.
  • Ne engedélyezze az ugyanazzal a kulccsal rendelkező elemek duplikálását.
  • Amikor az indexelővel tárol egy elemet a gyűjteményben:
    • Ha az elem rendelkezik olyan kulccsal, amely korábban a gyűjteményben volt, és az érték az null, akkor a kulcsnak megfelelő gyűjteményelem el lesz távolítva a gyűjteményből.
    • Ha az elem rendelkezik olyan kulccsal, amely korábban a gyűjteményben volt, és az érték nem null, az új elemérték lecseréli a gyűjteményben tárolt régi értéket.
    • Egyéb esetben az elem a gyűjteménybe kerül.
  • A hozzáadási metódus új elemet ad hozzá a gyűjteményhez, amennyiben nem létezik még elem ugyanazzal a kulccsal. Egyéb esetben kivételt ad vissza.
BooleanSwitch

Egyszerű be- és kikapcsoló funkciót biztosít, amely szabályozza a hibakeresést és a nyomkövetés kimenetét.

ConditionalAttribute

Azt jelzi a fordítóknak, hogy egy metódusmeghívást vagy attribútumot figyelmen kívül kell hagyni, hacsak nincs definiálva egy megadott feltételes fordítási szimbólum.

ConsoleTraceListener

A nyomkövetési vagy hibakeresési kimenetet a szabványos kimenetre vagy a szabványos hibakimenetre irányítja.

CorrelationManager

Összeveti azokat a nyomkövetéseket, amelyek egy logikai tranzakció részei.

CounterCreationData

Az egyéni számlálók számlálótípusát, nevét és súgósztringét határozza meg.

CounterCreationDataCollection

Erősen gépelt objektumgyűjteményt CounterCreationData biztosít.

CounterSampleCalculator

Segédprogramfüggvényeket biztosít a teljesítményszámláló adatainak értelmezéséhez.

DataReceivedEventArgs

Adatokat biztosít a OutputDataReceived és ErrorDataReceived eseményekhez.

Debug

Olyan metódusokat és tulajdonságokat biztosít, amelyek segítenek a kód hibakeresésében.

DebuggableAttribute

Módosítja a kódgenerálást a futásidejű just-in-time (JIT) hibakereséshez. Ez az osztály nem örökölhető.

Debugger

Lehetővé teszi a hibakeresővel való kommunikációt. Ez az osztály nem örökölhető.

DebuggerBrowsableAttribute

Meghatározza, hogy megjelenik-e, illetve hogyan jelenik meg egy tag a hibakeresési változó ablakaiban. Ez az osztály nem örökölhető.

DebuggerDisableUserUnhandledExceptionsAttribute

Ha a BreakForUserUnhandledException(Exception) API-t támogató .NET hibakereső van csatolva, a hibakereső nem szakít a felhasználó által kezelt kivételekkel, ha a kivételt ezzel az attribútummal rendelkező metódus észleli, kivéve, ha BreakForUserUnhandledException(Exception) van meghívva.

DebuggerDisplayAttribute

Meghatározza, hogyan jelenik meg egy osztály vagy mező a hibakeresési változó ablakaiban.

DebuggerHiddenAttribute

Megadja a DebuggerHiddenAttribute. Ez az osztály nem örökölhető.

DebuggerNonUserCodeAttribute

Azonosítja azt a típust vagy tagot, amely nem része az alkalmazás felhasználói kódjának.

DebuggerStepperBoundaryAttribute

Azt jelzi, hogy az attribútumot követő kódot futtatás módban kell végrehajtani, nem pedig lépés módban.

DebuggerStepThroughAttribute

Arra utasítja a hibakeresőt, hogy soronként végrehajtsa a kódot, ahelyett, hogy belelépne a kódba. Ez az osztály nem örökölhető.

DebuggerTypeProxyAttribute

Megadja egy típus megjelenítési proxyját.

DebuggerVisualizerAttribute

Megadja, hogy a típus rendelkezik-e vizualizációval. Ez az osztály nem örökölhető.

DefaultTraceListener

Biztosítja a nyomkövetés alapértelmezett kimeneti metódusát és működését.

DelimitedListTraceListener

Átirányítja a nyomkövetés vagy hibakeresés kimenetét egy szövegíróba, például streamíróba vagy egy olyan streambe, mint például a fájlstream.

DiagnosticListener

Az absztrakt DiagnosticSource osztály implementációját biztosítja, amely egy elnevezett helyet jelöl, ahová a forrás elküldi az információkat (eseményeket).

DiagnosticListenerExtensions

Olyan osztályokat biztosít, amelyek lehetővé teszik a rendszerfolyamatok, az eseménynaplók és a teljesítményszámlálók használatát.

DiagnosticMethodInfo

Egy metódus diagnosztikai információinak felel meg. Az osztály által biztosított információk hasonlóak az információkhoz

által MethodBase biztosított, de naplózási és nyomkövetési célokra szolgál.

DiagnosticsConfigurationHandler

A konfigurációs fájlok diagnosztikai szakaszát kezeli.

DiagnosticSource

Olyan absztrakt osztály, amely lehetővé teszi, hogy a kód éles környezetben történő, gazdag adattartalmakat tartalmazó naplózásra legyen előkészítve, az instrumentált folyamaton belüli felhasználás céljából.

DistributedContextPropagator

Egy implementáció DistributedContextPropagator határozza meg, hogy az elosztott környezeti információk kódolva és dekódolva lesznek-e a hálózaton való áthaladáskor. A kódolás átvihető bármely olyan hálózati protokollon keresztül, amely támogatja a sztringalapú kulcs-érték párokat. HTTP használata esetén például minden egyes kulcs-érték pár egy HTTP-fejléc. DistributedContextPropagator az értékeket sztringkulcs-érték párokként injektálja és kinyeri a hordozókból.

EntryWrittenEventArgs

Adatokat biztosít az EntryWritten eseményhez.

EventInstance

Az eseménynapló-bejegyzés nyelvsemleges adatait jelöli.

EventLog

Interakciót biztosít Windows eseménynaplókkal.

EventLogEntry

Egyetlen rekordot ágyaz be az eseménynaplóba. Ez az osztály nem örökölhető.

EventLogEntryCollection

A példányok gyűjteményének EventLogEntry méretét és enumerátorait határozza meg.

EventLogInstaller

Lehetővé teszi egy eseménynapló telepítését és konfigurálását, amelyről az alkalmazás olvas vagy ír futás közben.

EventLogPermission

Szabályozza az eseménynaplózás kódhozzáférés-engedélyeit.

EventLogPermissionAttribute

Engedélyezi a deklaratív engedélyellenőrzéseket az eseménynaplózáshoz.

EventLogPermissionEntry

A kódhozzáférés biztonsági engedélyének legkisebb egysége, amely egy EventLogadott kódhoz van beállítva.

EventLogPermissionEntryCollection

Erősen gépelt objektumgyűjteményt EventLogPermissionEntry tartalmaz.

EventLogTraceListener

Egyszerű figyelőt biztosít, amely a kimenet nyomon követését vagy hibakeresését irányítja egy EventLog.

EventSchemaTraceListener

A végpontok közötti események kimenetének nyomon követését vagy hibakeresését egy XML-kódolt, sémamegfelelő naplófájlba irányítja.

EventSourceCreationData

Az eseménynapló-forrás helyi számítógépen vagy távoli számítógépen történő létrehozásához használt konfigurációs beállításokat jelöli.

EventTypeFilter

Azt jelzi, hogy a figyelőnek nyomon kell-e követnie az eseménytípus alapján.

FileVersionInfo

A lemezen lévő fizikai fájl verzióadatait tartalmazza.

InitializingSwitchEventArgs

Adatokat biztosít a Switch.Initializing eseményhez.

InitializingTraceSourceEventArgs

Adatokat biztosít a TraceSource.Initializing eseményhez.

InstanceData

A teljesítményszámláló-mintához társított példányadatokat tárolja.

InstanceDataCollection

Erősen gépelt objektumgyűjteményt InstanceData biztosít.

InstanceDataCollectionCollection

Erősen gépelt objektumgyűjteményt InstanceDataCollection biztosít.

MonitoringDescriptionAttribute

Megadja egy tulajdonság vagy esemény leírását.

PerformanceCounter

Egy Windows NT-teljesítményszámláló összetevőt jelöl.

PerformanceCounterCategory

Teljesítményobjektumot jelöl, amely a teljesítményszámlálók kategóriáját határozza meg.

PerformanceCounterInstaller

Megadja a(z) PerformanceCounter összetevő telepítőjét.

PerformanceCounterManager

A teljesítményszámlálók használatakor a rendszer betöltési performance.dll készíti elő a teljesítményadatokat.

PerformanceCounterPermission

Engedélyezi a kódhozzáférés engedélyeinek vezérlését a következőhöz PerformanceCounter: .

PerformanceCounterPermissionAttribute

Engedélyezi a deklaratív teljesítményszámláló engedélyellenőrzését.

PerformanceCounterPermissionEntry

A kódhozzáférés biztonsági engedélyének legkisebb egysége, amely egy adott kódhoz PerformanceCountervan beállítva.

PerformanceCounterPermissionEntryCollection

Erősen gépelt objektumgyűjteményt PerformanceCounterPermissionEntry tartalmaz.

PresentationTraceSources

Olyan hibakeresési támogatást nyújt, amely kifejezetten Windows megjelenítési alaprendszer (WPF) alkalmazásokhoz van megcélzva.

Process

Hozzáférést biztosít a helyi és távoli folyamatokhoz, és lehetővé teszi a helyi rendszerfolyamatok elindítását és leállítását.

ProcessExitStatus

Olyan osztályokat biztosít, amelyek lehetővé teszik a rendszerfolyamatok, az eseménynaplók és a teljesítményszámlálók használatát.

ProcessModule

Egy adott folyamatba betöltött .dll vagy .exe fájlt jelöl.

ProcessModuleCollection

Erősen gépelt objektumgyűjteményt ProcessModule biztosít.

ProcessStartInfo

A folyamat indításakor használt értékkészletet adja meg.

ProcessTextOutput

Olyan osztályokat biztosít, amelyek lehetővé teszik a rendszerfolyamatok, az eseménynaplók és a teljesítményszámlálók használatát.

ProcessThread

Operációsrendszer-folyamatszálat jelöl.

ProcessThreadCollection

Erősen gépelt objektumgyűjteményt ProcessThread biztosít.

SourceFilter

Jelzi, hogy a nyomkövetési forrás alapján a figyelőnek nyomon kell-e követnie egy üzenetet.

SourceSwitch

Egy többszintű kapcsolóval lehetővé teszi a nyomkövetési és hibakeresési kimenet vezérlését a kód újrafordítása nélkül.

StackFrame

Információt nyújt az StackFrameaktuális szál hívásveremén található függvényhívásokról.

StackFrameExtensions

Bővítménymetelyeket biztosít az StackFrame osztályhoz, amelyek az aktuális szál hívási vermén lévő függvényhívást jelölik.

StackTrace

Egy veremnyomkövetést jelent, amely egy vagy több veremkeret rendezett gyűjteményéből áll.

StackTraceHiddenAttribute

A StackTraceHidden attribútummal ellátott típusok és metódusok ki lesznek hagyva a StackTrace.ToString() és az Exception.StackTrace hívásláncszövegéből.

Stopwatch

Az eltelt idő pontos mérésére alkalmas metódus- és tulajdonságkészletet biztosít.

Switch

Absztrakt alaposztályt biztosít az új hibakeresési és nyomkövetési kapcsolók létrehozásához.

SwitchAttribute

Egy szerelvényben, osztályban vagy tagban használt kapcsolót azonosít.

SwitchLevelAttribute

Azonosítja a kapcsoló szintjének típusát.

TextWriterTraceListener

A kimenet nyomon követését vagy hibakeresését irányítja egy TextWriter vagy több Stream, például FileStream.

Trace

Olyan metódusokat és tulajdonságokat biztosít, amelyek segítik a kód végrehajtásának nyomkövetését. Ez az osztály nem örökölhető.

TraceConfiguration

Módszereket biztosít a nyomkövetési beállítások regisztrálására és konfigurálására a konfigurációs fájloktól a kapcsolódó osztályokig TraceSource .

TraceEventCache

Egy szálra és folyamatra vonatkozó nyomkövetési eseményadatokat biztosít.

TraceFilter

A nyomkövetési szűrő implementációinak alaposztályát biztosítja.

TraceListener

A nyomkövetési abstract és hibakeresési kimenetet figyelő figyelők alaposztályát biztosítja.

TraceListenerCollection

Az objektumok szálbiztos listáját TraceListener tartalmazza.

TraceSource

Olyan módszereket és tulajdonságokat biztosít, amelyek lehetővé teszik az alkalmazások számára a kód végrehajtásának nyomon követését és a nyomkövetési üzenetek forráshoz való társítását.

TraceSwitch

Egy többszintű kapcsolóval lehetővé teszi a nyomkövetési és hibakeresési kimenet vezérlését a kód újrafordítása nélkül.

UnescapedXmlDiagnosticData

Nem beágyazott XML-adatokat biztosít a felhasználó által megadott nyomkövetési adatok naplózásához.

UnreachableException

Az a kivétel, amely akkor jelentkezik, amikor a program végrehajt egy elérhetetlennek vélt utasítást.

XmlWriterTraceListener

Xml-kóddal kódolt adatokként irányítja a kimenet nyomon követését vagy hibakeresését egy TextWriter vagy egy Stream, például egy FileStream.

Struktúrák

Name Description
Activity.Enumerator<T>

Egy objektumon Activity tárolt adatok számbavétele.

ActivityChangedEventArgs

Adatokat biztosít az CurrentChanged eseményhez.

ActivityContext

A W3C TraceContext specifikációjának megfelelő ábrázolás. Két azonosítót tartalmaz: egy TraceId-et és egy SpanId-et, valamint egy közös TraceFlags- és rendszerspecifikus TraceState-értékeket.

ActivityCreationOptions<T>

Beágyazza a tevékenységfigyelőnek küldött összes információt, hogy döntéseket hozzon a tevékenységpéldány létrehozásával és állapotával kapcsolatban.

A lehetséges általános típusparaméterek a következők: ActivityContext vagy String.

ActivityEvent

Egy nevet és időbélyeget tartalmazó eseményt, valamint a címkék választható listáját jelöli.

ActivityLink

A tevékenységek nulla vagy több olyan tevékenységkörnyezet-példányhoz kapcsolhatók, amelyek ok-okozati kapcsolatban állnak.

A tevékenységhivatkozások egyetlen nyomkövetésen vagy különböző nyomkövetéseken belül mutathatnak tevékenységkörnyezetekre.

A tevékenységhivatkozások olyan kötegelt műveleteket jelölhetnek, amelyekben egy tevékenységet több kezdeményező tevékenység kezdeményezett, amelyek mindegyike egyetlen bejövő elemet jelöl, amelyet a kötegben dolgoznak fel.

ActivitySpanId

SpanId W3C szabvány alapján formázott formátumot jelöl.

ActivityTagsCollection.Enumerator

Egy ActivityTagsCollection.

ActivityTraceId

TraceId Egy W3C szabványon alapuló formátumot jelöl.

CounterSample

Egy teljesítményszámláló nyers adatait tartalmazó struktúrát definiál.

Debug.AssertInterpolatedStringHandler

Interpolált sztringkezelőt Assert(Boolean) biztosít, amely csak akkor hajt végre formázást, ha az állítás sikertelen.

Debug.WriteIfInterpolatedStringHandler

Interpolált sztringkezelőt WriteIf(Boolean, String) biztosít, amely WriteLineIf(Boolean, Object) csak akkor hajtja végre a formázást, ha a feltétel érvényes.

ProcessOutputLine

Olyan osztályokat biztosít, amelyek lehetővé teszik a rendszerfolyamatok, az eseménynaplók és a teljesítményszámlálók használatát.

TagList

Az index által elérhető címkék listáját jelöli. Listák keresésére, rendezésére és módosítására használható módszereket biztosít.

TagList.Enumerator

Címkelista-gyűjtemények bejárására szolgáló enumerátor.

Interfészek

Name Description
ICollectData

Előkészíti a teljesítményadatokat a teljesítményszámlálók használatakor a rendszer által betöltődött teljesítmény DLL-hez.

Enumerációk

Name Description
ActivityIdFormat

Megadja a tulajdonság formátumát Id .

ActivityKind

A tevékenység, a szülők és gyermekei közötti kapcsolatot egy nyomban ismerteti.

ActivitySamplingResult

A kapcsolódó Activityadatok gyűjtéséhez használt ActivityListener számbavételi értékek. Több adat kérése nagyobb teljesítményterhelést okoz.

ActivityStatusCode

Adja meg a tevékenység állapotkódját, amely a rendszerezett művelet állapotát jelzi.

ActivityTraceFlags

A W3C szabvány által meghatározott, tevékenységhez társított jelzőket adja meg.

DebuggableAttribute.DebuggingModes

Az igény szerinti (JIT) fordító hibakeresési módját adja meg.

DebuggerBrowsableState

Megjeleníti a hibakereső megjelenítési utasításait.

EventLogEntryType

Egy eseménynapló-bejegyzés eseménytípusát adja meg.

EventLogPermissionAccess

Az engedélyosztályok által EventLog használt hozzáférési szinteket határozza meg.

OverflowAction

Meghatározza, hogyan kezelhetők a maximális fájlméretet elérő eseménynapló bejegyzései.

PerformanceCounterCategoryType

Azt jelzi, hogy a teljesítményszámláló kategóriája több példányt is tartalmazhat-e.

PerformanceCounterInstanceLifetime

A teljesítményszámláló-példány élettartamát adja meg.

PerformanceCounterPermissionAccess

Az engedélyosztályok által PerformanceCounter használt hozzáférési szinteket határozza meg.

PerformanceCounterType

Olyan teljesítményszámlálótípusokat határoz meg, amelyek közvetlenül natív típusokra képeznek le.

PresentationTraceLevel

Egy adott objektum nyomon követésének részletességi szintjét ismerteti.

ProcessPriorityClass

Azt a prioritást jelzi, amelyet a rendszer egy folyamathoz társít. Ez az érték és a folyamat egyes szálainak prioritási értéke határozza meg az egyes szálak alap prioritási szintjét.

ProcessWindowStyle

Megadva, hogyan jelenjen meg egy új ablak, amikor a rendszer elindít egy folyamatot.

SourceLevels

Meghatározza a forráskapcsoló és az eseménytípus szűrője által szűrt nyomkövetési üzenetek szintjét.

ThreadPriorityLevel

A szál prioritási szintjét adja meg.

ThreadState

A szál aktuális végrehajtási állapotát adja meg.

ThreadWaitReason

Megadja, hogy egy szál miért várakozik.

TraceEventType

Azonosítja a nyomkövetést okozó esemény típusát.

TraceLevel

Megadja, hogy milyen üzeneteket kell kihozni a Debug, Trace és TraceSwitch az osztályok számára.

TraceLogRetentionOption

Megadja a naplóhoz használni kívánt fájlstruktúrát EventSchemaTraceListener .

TraceOptions

A nyomkövetési kimenetbe írandó nyomkövetési adatbeállításokat adja meg.

Delegáltak

Name Description
DataReceivedEventHandler

Azt a metódust jelöli, amely egy eseményt vagy OutputDataReceived eseményt ErrorDataReceivedfog kezelniProcess.

DistributedContextPropagator.PropagatorGetterCallback

A propagátorok kinyerési módszereiben használt visszahívási metódust jelöli. A rendszer meghívja a visszahívást egy elnevezett mező értékének kereséséhez.

DistributedContextPropagator.PropagatorSetterCallback

A propagátorok injektálási módszereiben használt visszahívási metódust jelöli. A rendszer meghívja ezt a visszahívást egy elnevezett mező értékének beállításához. A propagátorok többször is meghívhatják, hogy több mezőt állítsanak be.

EntryWrittenEventHandler

Azt a metódust jelöli, amely egy EntryWritten .EventLog

ExceptionRecorder

Meghatározza az értesítések fogadásához használandó ActivityListener visszahívást, amikor kivételeket ad hozzá a Activity.

SampleActivity<T>

A mintavételezési folyamat során használt visszahívások aláírását ActivityListener meghatározó meghatalmazott.

Megjegyzések

  • Az EventLog összetevő képes az eseménynaplókba való írásra, az eseménynapló-bejegyzések olvasására, valamint a hálózat eseménynaplóinak és eseményforrásainak létrehozására és törlésére. Így EntryWrittenEventHandler aszinkron módon kezelheti az eseménynaplókat. A támogató osztályok hozzáférést biztosítanak a részletesebb vezérléshez, beleértve a következőket: engedélykorlátozások, eseménynapló-típusok megadása (amelyek az eseménynapló-bejegyzésekkel írt alapértelmezett adatok típusát szabályozzák), valamint az eseménynapló-bejegyzések gyűjteményein való végighaladás. További információ ezekről a EventLogPermissionfeladatokról: , EventLogEntryTypeés EventLogEntryCollection osztályok.

  • Az Process osztály funkcióval figyeli a hálózati folyamatokat, valamint elindítja és leállítja a helyi rendszerfolyamatokat. A futó folyamatok listáinak lekérése (a számítógép, a folyamatnév vagy a folyamatazonosító megadásával) vagy a processzorhoz jelenleg hozzáférő folyamattal kapcsolatos információk megtekintése mellett részletes ismereteket szerezhet a folyamatszálakról és a modulokról mind az osztályon keresztül Process , mind az ProcessThreadProcessModule osztályokkal való interakcióval. Az ProcessStartInfo osztály segítségével számos olyan elemet adhat meg, amelyekkel új folyamatot indíthat el, például bemenetet, kimenetet és hibastreameket, munkakönyvtárakat, parancssori parancsokat és argumentumokat. Ezekkel finomhangoltan szabályozhatja a folyamatok viselkedését. További kapcsolódó osztályok használatával megadhatja az ablakstílusokat, a folyamat- és szálprioritásokat, valamint kezelheti a szálak és modulok gyűjteményeit.

  • Az PerformanceCounter osztály lehetővé teszi a rendszer teljesítményének monitorozását, míg az PerformanceCounterCategory osztály új egyéni számlálók és kategóriák létrehozását teszi lehetővé. Írhat helyi egyéni számlálókba, és olvashat helyi, illetve távoli (rendszer- és egyéni) számlálókból. Az osztály használatával PerformanceCounter mintaszámlálókat is mintát vehet, és az osztály használatával kiszámíthatja az CounterSample egymást követő teljesítményszámláló-minták eredményeit. Az CounterCreationData osztály lehetővé teszi, hogy több számlálót hozzon létre egy kategóriában, és megadhatja azok típusát. A teljesítményszámláló összetevőhöz kapcsolódó egyéb osztályok hozzáférést biztosítanak a számlálók gyűjteményéhez, a számlálóengedélyekhez és a számlálótípusokhoz.

A System.Diagnostics névtér olyan osztályokat is biztosít, amelyek lehetővé teszik az alkalmazás hibakeresését és a kód végrehajtásának nyomon követését. További információ: Trace és Debug osztályok.