System.Diagnostics Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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:
|
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 |
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 |
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.