Activity Classe
Definizione
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.
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 |
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 |
| AddTag(String, String) |
Aggiorna per Activity avere un nuovo tag con l'oggetto specificato |
| 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 |
| 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 è |
| SetCustomProperty(String, Object) |
Associa qualsiasi oggetto personalizzato a questa attività. Se l'oggetto specificato |
| 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 |
| 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. |