Condividi tramite


System.Diagnostics Spazio dei nomi

Fornisce classi che consentono di interagire con processi di sistema, registri eventi e contatori delle prestazioni.

Classi

Activity

Rappresenta un'operazione con contesto da utilizzare per la registrazione.

ActivityListener

Consente di ascoltare gli eventi di avvio e arresto dell'attività e offre la possibilità di decidere di creare un'attività per scenari di campionamento.

ActivitySource

Fornisce API per creare e avviare Activity oggetti e registrare ActivityListener oggetti in ascolto degli eventi Activity.

ActivityTagsCollection

ActivityTagsCollection è una classe di raccolta usata per archiviare i tag di traccia.

Questa raccolta verrà usata con classi come ActivityEvent e ActivityLink.

Questa raccolta si comporta come segue:

  • Gli elementi della raccolta verranno ordinati in base alla modalità di aggiunta.
  • Non consentire la duplicazione degli elementi con la stessa chiave.
  • Quando si usa l'indicizzatore per archiviare un elemento nella raccolta:
    • Se l'elemento dispone di una chiave esistente in precedenza nella raccolta e il valore è null, l'elemento della raccolta corrispondente alla chiave verrà rimosso dall'insieme.
    • Se l'elemento dispone di una chiave esistente in precedenza nella raccolta e il valore non è null, il nuovo valore dell'elemento sostituirà il valore precedente archiviato nella raccolta.
    • In caso contrario, l'elemento verrà aggiunto all'insieme.
  • Aggiungi metodo aggiungerà un nuovo elemento alla raccolta se un elemento non esiste già con la stessa chiave. In caso contrario, genererà un'eccezione.
BooleanSwitch

Fornisce un semplice interruttore attivato/disattivato che controlla il debug e l'output di traccia.

ConditionalAttribute

Indica ai compilatori che una chiamata al metodo o un attributo devono essere ignorati a meno che non sia definito un simbolo di compilazione condizionale specificato.

ConsoleTraceListener

Indirizza l'output di traccia o debug all'output standard o al flusso di errore standard.

CorrelationManager

Correla le tracce che fanno parte di una transazione logica.

CounterCreationData

Definisce il tipo di contatore, il nome e la stringa della Guida per un contatore personalizzato.

CounterCreationDataCollection

Fornisce una raccolta fortemente tipizzata di oggetti CounterCreationData.

CounterSampleCalculator

Fornisce un set di funzioni di utilità per interpretare i dati dei contatori delle prestazioni.

DataReceivedEventArgs

Fornisce dati per gli eventi OutputDataReceived e ErrorDataReceived.

Debug

Fornisce un set di metodi e proprietà che consentono di eseguire il debug del codice.

DebuggableAttribute

Modifica la generazione di codice per il debug JIT (Just-In-Time). Questa classe non può essere ereditata.

Debugger

Abilita la comunicazione con un debugger. Questa classe non può essere ereditata.

DebuggerBrowsableAttribute

Determina se e come viene visualizzato un membro nelle finestre delle variabili del debugger. Questa classe non può essere ereditata.

DebuggerDisableUserUnhandledExceptionsAttribute

Se è collegato un debugger .NET che supporta l'API BreakForUserUnhandledException(Exception), il debugger non interromperà le eccezioni non gestite dall'utente quando l'eccezione viene intercettata da un metodo con questo attributo, a meno che non venga chiamato BreakForUserUnhandledException(Exception).

DebuggerDisplayAttribute

Determina la modalità di visualizzazione di una classe o di un campo nelle finestre delle variabili del debugger.

DebuggerHiddenAttribute

Specifica il DebuggerHiddenAttribute. Questa classe non può essere ereditata.

DebuggerNonUserCodeAttribute

Identifica un tipo o un membro che non fa parte del codice utente per un'applicazione.

DebuggerStepperBoundaryAttribute

Indica il codice che segue l'attributo deve essere eseguito in esecuzione, non in modalità passaggio.

DebuggerStepThroughAttribute

Indica al debugger di eseguire il codice invece di eseguire istruzioni nel codice. Questa classe non può essere ereditata.

DebuggerTypeProxyAttribute

Specifica il proxy di visualizzazione per un tipo.

DebuggerVisualizerAttribute

Specifica che il tipo ha un visualizzatore. Questa classe non può essere ereditata.

DefaultTraceListener

Fornisce i metodi di output e il comportamento predefiniti per la traccia.

DelimitedListTraceListener

Indirizza l'output di traccia o debug a un writer di testo, ad esempio un writer di flusso o a un flusso, ad esempio un flusso di file.

DiagnosticListener

Fornisce un'implementazione della classe astratta DiagnosticSource che rappresenta una posizione denominata a cui un'origine invia le informazioni (eventi).

DiagnosticListenerExtensions

Fornisce classi che consentono di interagire con processi di sistema, registri eventi e contatori delle prestazioni.

DiagnosticMethodInfo

Rappresenta le informazioni di diagnostica su un metodo. Le informazioni fornite da questa classe sono simili alle informazioni

fornito da MethodBase, ma è destinato a scopi di registrazione e traccia.

DiagnosticsConfigurationHandler

Gestisce la sezione diagnostica dei file di configurazione.

DiagnosticSource

Classe astratta che consente di instrumentare il codice per la registrazione in fase di produzione di payload di dati avanzati per l'utilizzo all'interno del processo instrumentato.

DistributedContextPropagator

Un'implementazione di DistributedContextPropagator determina se e come le informazioni sul contesto distribuito vengono codificate e decodificate durante l'attraversamento della rete. La codifica può essere trasportata su qualsiasi protocollo di rete che supporta coppie chiave-valore stringa. Ad esempio, quando si usa HTTP, ogni coppia chiave-valore è un'intestazione HTTP. DistributedContextPropagator inserisce i valori in ed estrae i valori dai vettori come coppie chiave-valore stringa.

EntryWrittenEventArgs

Fornisce dati per l'evento EntryWritten.

EventInstance

Rappresenta informazioni indipendenti dalla lingua per una voce del registro eventi.

EventLog

Fornisce l'interazione con i registri eventi di Windows.

EventLogEntry

Incapsula un singolo record nel registro eventi. Questa classe non può essere ereditata.

EventLogEntryCollection

Definisce le dimensioni e gli enumeratori per una raccolta di istanze di EventLogEntry.

EventLogInstaller

Consente di installare e configurare un registro eventi da cui l'applicazione legge o scrive durante l'esecuzione.

EventLogPermission

Controlla le autorizzazioni di accesso al codice per la registrazione degli eventi.

EventLogPermissionAttribute

Consente controlli di autorizzazione dichiarativa per la registrazione degli eventi.

EventLogPermissionEntry

Definisce l'unità più piccola di un'autorizzazione di sicurezza per l'accesso al codice impostata per un EventLog.

EventLogPermissionEntryCollection

Contiene una raccolta fortemente tipizzata di oggetti EventLogPermissionEntry.

EventLogTraceListener

Fornisce un listener semplice che indirizza l'output di traccia o debug a un EventLog.

EventSchemaTraceListener

Indirizza l'output di traccia o debug di eventi end-to-end a un file di log con codifica XML conforme allo schema.

EventSourceCreationData

Rappresenta le impostazioni di configurazione utilizzate per creare un'origine del registro eventi nel computer locale o in un computer remoto.

EventTypeFilter

Indica se un listener deve tracciare in base al tipo di evento.

FileVersionInfo

Fornisce informazioni sulla versione per un file fisico su disco.

InitializingSwitchEventArgs

Fornisce dati per l'evento Switch.Initializing .

InitializingTraceSourceEventArgs

Fornisce dati per l'evento TraceSource.Initializing .

InstanceData

Contiene i dati dell'istanza associati a un esempio di contatore delle prestazioni.

InstanceDataCollection

Fornisce una raccolta fortemente tipizzata di oggetti InstanceData.

InstanceDataCollectionCollection

Fornisce una raccolta fortemente tipizzata di oggetti InstanceDataCollection.

MonitoringDescriptionAttribute

Specifica una descrizione per una proprietà o un evento.

PerformanceCounter

Rappresenta un componente del contatore delle prestazioni di Windows NT.

PerformanceCounterCategory

Rappresenta un oggetto prestazioni, che definisce una categoria di contatori delle prestazioni.

PerformanceCounterInstaller

Specifica un programma di installazione per il componente PerformanceCounter.

PerformanceCounterManager

Prepara i dati sulle prestazioni per il performance.dll il sistema viene caricato quando si utilizzano contatori delle prestazioni.

PerformanceCounterPermission

Consente il controllo delle autorizzazioni di accesso al codice per PerformanceCounter.

PerformanceCounterPermissionAttribute

Consente controlli di autorizzazione del contatore delle prestazioni dichiarativi.

PerformanceCounterPermissionEntry

Definisce l'unità più piccola di un'autorizzazione di sicurezza per l'accesso al codice impostata per un PerformanceCounter.

PerformanceCounterPermissionEntryCollection

Contiene una raccolta fortemente tipizzata di oggetti PerformanceCounterPermissionEntry.

PresentationTraceSources

Fornisce il supporto per la traccia di debug destinato specificamente alle applicazioni Windows Presentation Foundation (WPF).

Process

Fornisce l'accesso ai processi locali e remoti e consente di avviare e arrestare i processi del sistema locale.

ProcessModule

Rappresenta un file .dll o .exe caricato in un processo specifico.

ProcessModuleCollection

Fornisce una raccolta fortemente tipizzata di oggetti ProcessModule.

ProcessStartInfo

Specifica un set di valori utilizzati all'avvio di un processo.

ProcessThread

Rappresenta un thread di processo del sistema operativo.

ProcessThreadCollection

Fornisce una raccolta fortemente tipizzata di oggetti ProcessThread.

SourceFilter

Indica se un listener deve tracciare un messaggio in base all'origine di una traccia.

SourceSwitch

Fornisce un commutatore a più livelli per controllare la traccia e il debug dell'output senza ricompilare il codice.

StackFrame

Fornisce informazioni su un StackFrame, che rappresenta una chiamata di funzione nello stack di chiamate per il thread corrente.

StackFrameExtensions

Fornisce metodi di estensione per la classe StackFrame, che rappresenta una chiamata di funzione nello stack di chiamate per il thread corrente.

StackTrace

Rappresenta un'analisi dello stack, che è una raccolta ordinata di uno o più stack frame.

StackTraceHiddenAttribute

I tipi e i metodi attribuiti con StackTraceHidden verranno omessi dal testo di analisi dello stack illustrato in StackTrace.ToString() ed Exception.StackTrace

Stopwatch

Fornisce un set di metodi e proprietà che è possibile utilizzare per misurare in modo accurato il tempo trascorso.

Switch

Fornisce una classe base astratta per creare nuovi commutatori di debug e traccia.

SwitchAttribute

Identifica un'opzione utilizzata in un assembly, una classe o un membro.

SwitchLevelAttribute

Identifica il tipo di livello per un'opzione.

TextWriterTraceListener

Indirizza l'output di traccia o debug a un TextWriter o a un Stream, ad esempio FileStream.

Trace

Fornisce un set di metodi e proprietà che consentono di tracciare l'esecuzione del codice. Questa classe non può essere ereditata.

TraceConfiguration

Fornisce classi che consentono di interagire con processi di sistema, registri eventi e contatori delle prestazioni.

TraceEventCache

Fornisce dati dell'evento di traccia specifici di un thread e di un processo.

TraceFilter

Fornisce la classe base per le implementazioni del filtro di traccia.

TraceListener

Fornisce la classe di base abstract per i listener che monitorano l'output di traccia e di debug.

TraceListenerCollection

Fornisce un elenco thread-safe di oggetti TraceListener.

TraceSource

Fornisce un set di metodi e proprietà che consentono alle applicazioni di tracciare l'esecuzione del codice e associare messaggi di traccia alla relativa origine.

TraceSwitch

Fornisce un commutatore a più livelli per controllare la traccia e il debug dell'output senza ricompilare il codice.

UnescapedXmlDiagnosticData

Fornisce dati XML senza caratteri di escape per la registrazione dei dati di traccia forniti dall'utente.

UnreachableException

Eccezione generata quando il programma esegue un'istruzione che è stata considerata non raggiungibile.

XmlWriterTraceListener

Indirizza l'output di traccia o debug come dati con codifica XML a un TextWriter o a un Stream, ad esempio un FileStream.

Struct

Activity.Enumerator<T>

Enumera i dati archiviati in un oggetto Activity.

ActivityChangedEventArgs

Fornisce dati per l'evento CurrentChanged.

ActivityContext

Rappresentazione conforme alla specifica W3C TraceContext. Contiene due identificatori: TraceId e SpanId, insieme a un set di valori TraceFlags comuni e TraceState specifici del sistema.

ActivityCreationOptions<T>

Incapsula tutte le informazioni inviate al listener di attività, per prendere decisioni sulla creazione dell'istanza dell'attività, nonché sul relativo stato.

I possibili parametri di tipo generico sono ActivityContext o String.

ActivityEvent

Rappresenta un evento contenente un nome e un timestamp, nonché un elenco facoltativo di tag.

ActivityLink

Le attività possono essere collegate a zero o più istanze del contesto di attività correlate in modo causale.

I collegamenti attività possono puntare ai contesti di attività all'interno di una singola traccia o in tracce diverse.

I collegamenti attività possono essere usati per rappresentare le operazioni in batch in cui un'attività è stata avviata da più attività di avvio, ognuna che rappresenta un singolo elemento in ingresso elaborato nel batch.

ActivitySpanId

Rappresenta un SpanId formattato in base a uno standard W3C.

ActivityTagsCollection.Enumerator

Enumera gli elementi di un ActivityTagsCollection.

ActivityTraceId

Rappresenta un TraceId il cui formato è basato su uno standard W3C.

CounterSample

Definisce una struttura che contiene i dati non elaborati per un contatore delle prestazioni.

Debug.AssertInterpolatedStringHandler

Fornisce un gestore di stringhe interpolato per Assert(Boolean) che esegue la formattazione solo se l'asserzione ha esito negativo.

Debug.WriteIfInterpolatedStringHandler

Fornisce un gestore di stringhe interpolato per WriteIf(Boolean, String) e WriteLineIf(Boolean, Object) che esegue la formattazione solo se la condizione viene applicata.

TagList

Rappresenta un elenco di tag a cui è possibile accedere in base all'indice. Fornisce metodi per la ricerca, l'ordinamento e la modifica degli elenchi.

TagList.Enumerator

Enumeratore per l'attraversamento di una raccolta di elenchi di tag.

Interfacce

ICollectData

Prepara i dati sulle prestazioni per la DLL delle prestazioni caricata dal sistema durante l'utilizzo dei contatori delle prestazioni.

Enumerazioni

ActivityIdFormat

Specifica il formato della proprietà Id.

ActivityKind

Descrive la relazione tra l'attività, i relativi elementi padre e i relativi figli in una traccia.

ActivitySamplingResult

Valori di enumerazione usati da ActivityListener per indicare la quantità di dati da raccogliere per il Activitycorrelato. La richiesta di più dati comporta un sovraccarico delle prestazioni maggiore.

ActivityStatusCode

Definire il codice di stato dell'attività che indica lo stato dell'operazione instrumentata.

ActivityTraceFlags

Specifica i flag definiti dallo standard W3C associato a un'attività.

DebuggableAttribute.DebuggingModes

Specifica la modalità di debug per il compilatore JIT (Just-In-Time).

DebuggerBrowsableState

Fornisce istruzioni di visualizzazione per il debugger.

EventLogEntryType

Specifica il tipo di evento di una voce del registro eventi.

EventLogPermissionAccess

Definisce i livelli di accesso usati dalle classi di autorizzazione EventLog.

OverflowAction

Specifica come gestire le voci in un registro eventi che ha raggiunto le dimensioni massime del file.

PerformanceCounterCategoryType

Indica se la categoria del contatore delle prestazioni può avere più istanze.

PerformanceCounterInstanceLifetime

Specifica la durata di un'istanza del contatore delle prestazioni.

PerformanceCounterPermissionAccess

Definisce i livelli di accesso usati dalle classi di autorizzazione PerformanceCounter.

PerformanceCounterType

Specifica i tipi di contatore delle prestazioni che eseguono il mapping direttamente ai tipi nativi.

PresentationTraceLevel

Descrive il livello di dettaglio da tracciare su un particolare oggetto.

ProcessPriorityClass

Indica la priorità associata al sistema a un processo. Questo valore, insieme al valore di priorità di ogni thread del processo, determina il livello di priorità di base di ogni thread.

ProcessWindowStyle

Specificare la modalità di visualizzazione di una nuova finestra all'avvio di un processo da parte del sistema.

SourceLevels

Specifica i livelli dei messaggi di traccia filtrati dall'opzione di origine e dal filtro del tipo di evento.

ThreadPriorityLevel

Specifica il livello di priorità di un thread.

ThreadState

Specifica lo stato di esecuzione corrente del thread.

ThreadWaitReason

Specifica il motivo per cui un thread è in attesa.

TraceEventType

Identifica il tipo di evento che ha causato la traccia.

TraceLevel

Specifica i messaggi da restituire per le classi Debug, Trace e TraceSwitch.

TraceLogRetentionOption

Specifica la struttura di file che verrà utilizzata per il log EventSchemaTraceListener.

TraceOptions

Specifica le opzioni di dati di traccia da scrivere nell'output di traccia.

Delegati

DataReceivedEventHandler

Rappresenta il metodo che gestirà l'evento OutputDataReceived o ErrorDataReceived di un Process.

DistributedContextPropagator.PropagatorGetterCallback

Rappresenta il metodo di callback utilizzato nei metodi di estrazione dei propagatori. Il callback viene richiamato per cercare il valore di un campo denominato.

DistributedContextPropagator.PropagatorSetterCallback

Rappresenta il metodo di callback utilizzato nei metodi di inserimento dei propagator. Questo callback viene richiamato per impostare il valore di un campo denominato. I propagatori possono richiamarlo più volte per impostare più campi.

EntryWrittenEventHandler

Rappresenta il metodo che gestirà l'evento EntryWritten di un EventLog.

ExceptionRecorder

Fornisce classi che consentono di interagire con processi di sistema, registri eventi e contatori delle prestazioni.

SampleActivity<T>

Delegato che definisce la firma dei callback ActivityListener utilizzati nel processo di campionamento.

Commenti

  • Il componente EventLog fornisce funzionalità per scrivere nei registri eventi, leggere le voci del registro eventi e creare ed eliminare registri eventi e origini eventi nella rete. Il EntryWrittenEventHandler consente di interagire con i registri eventi in modo asincrono. Le classi di supporto forniscono l'accesso a un controllo più dettagliato, tra cui le restrizioni di autorizzazione, la possibilità di specificare i tipi di log eventi (che controllano il tipo di dati predefiniti scritti con una voce del registro eventi) e scorrere raccolte di voci del registro eventi. Per altre informazioni su queste attività, vedere le classi EventLogPermission, EventLogEntryTypee EventLogEntryCollection.

  • La classe Process fornisce funzionalità per monitorare i processi di sistema in rete e avviare e arrestare i processi di sistema locali. Oltre a recuperare elenchi di processi in esecuzione (specificando il computer, il nome del processo o l'ID del processo) o visualizzando informazioni sul processo che attualmente ha accesso al processore, è possibile ottenere una conoscenza dettagliata dei thread di processo e dei moduli sia tramite la classe Process stessa, sia interagendo con le classi ProcessThread e ProcessModule. La classe ProcessStartInfo consente di specificare un'ampia gamma di elementi con cui avviare un nuovo processo, ad esempio input, output e flussi di errore, directory di lavoro e verbi e argomenti della riga di comando. In questo modo è possibile controllare correttamente il comportamento dei processi. Altre classi correlate consentono di specificare stili di finestra, priorità di processo e thread e interagire con raccolte di thread e moduli.

  • La classe PerformanceCounter consente di monitorare le prestazioni del sistema, mentre la classe PerformanceCounterCategory consente di creare nuovi contatori e categorie personalizzati. È possibile scrivere in contatori personalizzati locali e leggere da contatori locali e remoti (sistema e personalizzato). È possibile campionare i contatori usando la classe PerformanceCounter e calcolare i risultati dei campioni successivi del contatore delle prestazioni usando la classe CounterSample. La classe CounterCreationData consente di creare più contatori in una categoria e specificarne i tipi. Altre classi associate al componente del contatore delle prestazioni forniscono l'accesso a raccolte di contatori, autorizzazioni contatori e tipi di contatore.

Lo spazio dei nomi System.Diagnostics fornisce anche classi che consentono di eseguire il debug dell'applicazione e di tracciare l'esecuzione del codice. Per altre informazioni, vedere le classi Trace e Debug.