Activity Classe

Definizione

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

public class Activity : IDisposable
public class Activity
Ereditarietà
Activity
Implementazioni

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.

Si applica a

Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8 (package-provided), 8, 9 (package-provided), 9
.NET Framework 4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided)
.NET Standard 2.0 (package-provided)