Activity Classe

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Pacchetto:

System.Diagnostics.DiagnosticSource v9.0.0-rc.2.24473.5

Origine:

Activity.cs

Rappresenta un'operazione con il contesto da usare per la registrazione.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Ereditarietà

Object

Activity

Implementazioni

IDisposable

Commenti

Un Activity oggetto ha un nome dell'operazione, un ID, un'ora di inizio e una durata, tag e bagagli.

L'attività corrente può essere accessibile con la proprietà statica Activity.Current .

Le attività devono essere create chiamando il costruttore, configurato in base alle esigenze e quindi avviato con il Start metodo, che gestisce le relazioni padre-figlio per le attività e i set Activity.Current.

Al termine di un'attività, deve essere arrestato con il Activity.Stop() metodo .

Tuttavia, se si elimina l'oggetto Activity , che lo arresta in modo che non sia necessario chiamare Activity.Stop()in modo esplicito . Che semplifica il modello di codifica. Per altre informazioni, vedere il metodo Dispose.

Nessun Activity metodo consente l'escape delle eccezioni come risposta agli input non valido. Vengono generati e rilevati (che consente ai debugger e ai monitoraggi di visualizzare l'errore), ma l'eccezione viene eliminata e l'operazione fa qualcosa di ragionevole (in genere non fa nulla).

Costruttori

Activity(String)

Inizializza una nuova istanza della classe Activity.

Proprietà

ActivityTraceFlags	Ottiene o imposta i flag definiti dalla specifica W3C ID che sono associati all'attività.
Baggage	Ottiene una raccolta di coppie chiave-valore che rappresenta le informazioni passate agli elementi figlio di questo Activity.
Context	Ottiene il contesto dell'attività. Il contesto diventa valido solo se l'attività è stata avviata.
Current	Ottiene o imposta l'operazione corrente (Activity) per il thread corrente. Il flusso passa attraverso le chiamate asincrone.
DefaultIdFormat	Ottiene o imposta il formato ID predefinito per Activity.
DisplayName	Ottiene o imposta il nome visualizzato dell'attività.
Duration	Ottiene la durata dell'operazione.
Events	Ottiene l'elenco di tutti gli eventi attività collegati a questa attività.
ForceDefaultIdFormat	Ottiene o imposta un valore che determina se usare sempre DefaultIdFormat per definire il formato ID predefinito.
HasRemoteParent	Ottiene un valore che indica se il contesto padre è stato creato dalla propagazione remota.
Id	Ottiene un identificatore specifico per una particolare richiesta.
IdFormat	Ottiene il formato per Id.
IsAllDataRequested	Ottiene o imposta un valore che indica se l'attività deve essere popolata con tutte le informazioni di propagazione e con tutte le altre proprietà, come collegamenti, tag ed eventi.
IsStopped	Ottiene un valore che indica se questo Activity oggetto viene arrestato o meno.
Kind	Ottiene la relazione tra l'attività, gli elementi padre e gli elementi figlio in un'analisi.
Links	Ottiene l'elenco di tutti i collegamenti attività collegati a questa attività.
OperationName	Ottiene il nome dell'operazione.
Parent	Ottiene l'elemento Activity padre che ha creato questa attività.
ParentId	Ottiene l'ID dell'elemento padre di questa attività.
ParentSpanId	Ottiene l'elemento SpanId del padre.
Recorded	Ottiene un valore che indica se il flag W3CIdFlags.Recorded è impostato.
RootId	Ottiene l'ID radice di questo Activity.
Source	Ottiene l'origine dell'attività associata all'attività corrente.
SpanId	Ottiene la parte SPAN di Id.
StartTimeUtc	Ottiene l'ora in cui è stata avviata l'operazione.
Status	Ottiene il codice di stato dell'oggetto attività corrente.
StatusDescription	Ottiene la descrizione dello stato dell'oggetto attività corrente.
TagObjects	Ottiene l'elenco dei tag che rappresentano le informazioni da registrare insieme all'attività. Queste informazioni non vengono passate agli elementi figlio dell'attività.
Tags	Ottiene una raccolta di coppie chiave-valore che rappresentano le informazioni che verranno registrate con Activity nel sistema di registrazione.
TraceId	Ottiene la parte TraceId di Id.
TraceIdGenerator	Quando si avvia un'attività che non ha un contesto padre, l'ID traccia verrà generato automaticamente usando numeri casuali. TraceIdGenerator può essere usato per eseguire l'override dell'algoritmo di generazione dell'ID traccia predefinito del runtime.
TraceStateString	Ottiene o imposta l'intestazione W3C tracestate.

Metodi

AddBaggage(String, String)	Aggiorna Activity in modo da avere un nuovo articolo del bagaglio con la chiave e il valore specificati.
AddEvent(ActivityEvent)	Aggiunge l'evento di attività specificato all'elenco di eventi.
AddException(Exception, TagList, DateTimeOffset)	Rappresenta un'operazione con il contesto da usare per la registrazione.
AddLink(ActivityLink)	Rappresenta un'operazione con il contesto da usare per la registrazione.
AddTag(String, Object)	Aggiorna l'attività in modo che sia presente un tag con key e value aggiuntivi.
AddTag(String, String)	Aggiorna Activity in modo da avere un nuovo tag con gli elementi key e value specificati.
Dispose()	Arresta l'attività se è già avviata e invia una notifica ai listener di eventi se presenti. In caso contrario non viene eseguita alcuna operazione.
Dispose(Boolean)	Quando viene eseguito l'override da un tipo derivato, questo metodo rilascia qualsiasi risorsa allocata.
EnumerateEvents()	Enumera gli oggetti collegati all'oggetto ActivityEvent Activity.
EnumerateLinks()	Enumera gli oggetti collegati all'oggetto ActivityLink Activity.
EnumerateTagObjects()	Enumera i tag associati a questo oggetto Activity.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaggageItem(String)	Restituisce il valore di una coppia chiave-valore aggiunta all'attività con AddBaggage(String, String).
GetCustomProperty(String)	Restituisce l'oggetto mappato al nome della proprietà specificato.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetTagItem(String)	Restituisce il valore del tag Activity mappato alla chiave di input. Restituisce null se tale chiave non esiste.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
SetBaggage(String, String)	Aggiungere o aggiornare il bagaglio attività con la chiave di input e il valore. Se il valore di input è null : se la raccolta ha un bagaglio con la stessa chiave, questo bagaglio verrà rimosso dalla raccolta. - in caso contrario, non si verificherà nulla e la raccolta non cambierà. Se il valore di input non null è - se la raccolta ha un bagaglio con la stessa chiave, il valore mappato a questa chiave verrà aggiornato con il nuovo valore di input. in caso contrario, la chiave e il valore verranno aggiunti come nuovo bagaglio alla raccolta. L'elemento bagaglio verrà aggiornato/rimosso solo se è stato aggiunto originale all'attività corrente. Gli elementi ereditati dai genitori non verranno modificati/rimossi, verrà aggiunto un nuovo elemento al bagaglio attività corrente.
SetCustomProperty(String, Object)	Associa qualsiasi oggetto personalizzato a questa attività. Se l'elemento propertyName specificato era in precedenza associato a un altro oggetto, la proprietà verrà aggiornata in modo da essere associata al nuovo elemento propertyValue. È consigliabile usare un nome di proprietà univoco per evitare conflitti con qualsiasi uso dello stesso valore.
SetEndTime(DateTime)	Aggiorna Activity per impostare il relativo Duration come differenza tra StartTimeUtc e l'ora di arresto specificata.
SetIdFormat(ActivityIdFormat)	Imposta il formato dell'ID per questo oggetto Activity prima dell'avvio.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	Imposta l'ID padre usando la convenzione W3C di TraceId e SpanId.
SetParentId(String)	Aggiorna questo elemento Activity per indicare che Activity con ID parentId ha causato Activity.
SetStartTime(DateTime)	Imposta l'ora di inizio di questo Activity.
SetStatus(ActivityStatusCode, String)	Imposta il codice di stato e la descrizione nell'oggetto attività corrente.
SetTag(String, Object)	Aggiunge o aggiorna il tag attività con la chiave e il valore di input.
Start()	Avvia l'attività.
Stop()	Arresta l'attività.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

CurrentChanged

Si verifica quando il valore dell'oggetto Current cambia.