Activity Classe

Definizione

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

public ref class Activity : IDisposable
public ref class Activity
public class Activity : IDisposable
public class Activity
type Activity = class
    interface IDisposable
type Activity = class
Public Class Activity
Implements IDisposable
Public Class Activity
Ereditarietà
Activity
Implementazioni

Commenti

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

È possibile accedere all'attività corrente 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 imposta Activity.Current.

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

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

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

Costruttori

Nome Descrizione
Activity(String)

Inizializza una nuova istanza della classe Activity.

Proprietà

Nome Descrizione
ActivityTraceFlags

Ottiene o imposta i flag (definiti dalla specifica DELL'ID W3C) associati all'attività.

Baggage

Ottiene una raccolta di coppie chiave/valore che rappresenta le informazioni passate agli elementi figlio di questo Activityoggetto .

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. Questo flusso tra 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 di attività associati a questa attività.

ForceDefaultIdFormat

Ottiene o imposta un valore che detrminese se DefaultIdFormat viene sempre utilizzato per definire il formato ID predefinito.

HasRandomizedTraceId

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

HasRemoteParent

Ottiene un valore che indica se il contesto padre è stato creato dalla propagazione remota.

Id

Ottiene un identificatore specifico di una determinata richiesta.

IdFormat

Ottiene il formato per l'oggetto Id.

IsAllDataRequested

Ottiene o imposta un valore che indica se questa attività deve essere popolata con tutte le informazioni di propagazione, nonché tutte le altre proprietà, ad esempio collegamenti, tag ed eventi.

IsStopped

Ottiene un valore che indica se l'oggetto Activity è stato arrestato o meno.

Kind

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

Links

Ottiene l'elenco di tutti i collegamenti di attività associati a questa attività.

OperationName

Ottiene il nome dell'operazione.

Parent

Ottiene l'elemento padre Activity che ha creato questa attività.

ParentId

Ottiene l'ID dell'elemento padre dell'attività.

ParentSpanId

Ottiene l'oggetto dell'oggetto SpanIdpadre.

Recorded

Ottiene un valore che indica se è impostato il flag W3CIdFlags.Recorded.

RootId

Ottiene l'ID radice dell'oggetto Activity.

Source

Ottiene l'origine dell'attività associata a questa attività.

SpanId

Ottiene la parte SPAN di Id.

StartTimeUtc

Ottiene l'ora di avvio dell'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 di tag che rappresentano le informazioni da registrare insieme all'attività. Queste informazioni non vengono passate agli elementi figlio di questa attività.

Tags

Ottiene una raccolta di coppie chiave/valore che rappresentano informazioni che verranno registrate insieme Activity al sistema di registrazione.

TraceId

Ottiene la parte TraceId dell'oggetto Id.

TraceIdGenerator

Quando si avvia un'attività che non dispone di un contesto padre, l'ID di traccia verrà generato automaticamente usando numeri casuali. TraceIdGenerator può essere usato per eseguire l'override dell'algoritmo di generazione predefinito dell'ID di traccia del runtime.

TraceStateString

Ottiene o imposta l'intestazione W3C tracestate .

Metodi

Nome Descrizione
AddBaggage(String, String)

Aggiorna per Activity avere un nuovo articolo bagaglio con la chiave e il valore specificati.

AddEvent(ActivityEvent)

Aggiunge l'evento di attività specificato all'elenco di eventi.

AddException(Exception, TagList, DateTimeOffset)

Aggiungere un ActivityEvent oggetto contenente le informazioni sull'eccezione all'elenco Events .

AddLink(ActivityLink)

Aggiunge un oggetto ActivityLink all'elenco Links .

AddTag(String, Object)

Aggiorna l'attività in modo che abbia un tag con un valore aggiuntivo key e value.

AddTag(String, String)

Aggiorna per Activity avere un nuovo tag con l'oggetto specificato key e value.

Dispose()

Arresta l'attività se è già stata avviata e invia una notifica a tutti i listener di eventi. In caso contrario, non succederà nulla.

Dispose(Boolean)

Quando ne viene eseguito l'override da un tipo derivato, questo metodo rilascia tutte le risorse allocate.

EnumerateEvents()

Enumera gli ActivityEvent oggetti associati a questo oggetto Activity.

EnumerateLinks()

Enumera gli ActivityLink oggetti associati a questo oggetto 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 la chiave non esiste.

GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
SetBaggage(String, String)

Aggiungere o aggiornare il bagaglio Attività con la chiave e il valore di input. 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 verrà eseguita alcuna operazione 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'articolo bagaglio verrà aggiornato/rimosso solo se è stato aggiunto originale all'attività corrente. Gli articoli ereditati dai genitori non verranno modificati/rimossi, il nuovo articolo verrà invece aggiunto al bagaglio di attività corrente.

SetCustomProperty(String, Object)

Associa qualsiasi oggetto personalizzato a questa attività. Se l'oggetto specificato propertyName è stato precedentemente associato a un altro oggetto, la proprietà verrà aggiornata in modo da essere associata al nuovo propertyValue oggetto. È consigliabile usare un nome di proprietà univoco per evitare conflitti con chiunque usi lo stesso valore.

SetEndTime(DateTime)

Aggiorna per Activity impostarne Duration la differenza tra StartTimeUtc e l'ora di arresto specificata.

SetIdFormat(ActivityIdFormat)

Imposta il formato ID in questo Activity oggetto prima dell'avvio.

SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)

Imposta l'ID padre usando la convenzione W3C di un TraceId e un SpanId.

SetParentId(String)

Aggiorna questo Activity oggetto per indicare che Activity con un ID di parentId ha causato questo Activityoggetto .

SetStartTime(DateTime)

Imposta l'ora di inizio di questo Activityoggetto .

SetStatus(ActivityStatusCode, String)

Imposta il codice di stato e la descrizione sull'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

Nome Descrizione
CurrentChanged

Si verifica quando il Current valore cambia.

Si applica a