Sdílet prostřednictvím


Activity Třída

Definice

Představuje operaci s kontextem, která se má použít k protokolování.

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
Dědičnost
Activity
Implementuje

Poznámky

Activity název operace, ID, čas a dobu zahájení, značky a zavazadla.

Aktuální aktivita je přístupná pomocí vlastnosti static Activity.Current .

Aktivity by měly být vytvořeny voláním konstruktoru, nakonfigurovány podle potřeby a pak zahájeny Start metodou, která udržuje vztahy nadřazenosti a podřízenosti pro aktivity a nastaví Activity.Current.

Po dokončení aktivity by měla být zastavena metodou Activity.Stop() .

Pokud ale objekt vyhodíte Activity , zastaví se, takže nemusíte explicitně volat Activity.Stop(). Tím se kódovací vzor zjednodušuje. Další informace najdete v Dispose metodě.

Žádné Activity metody neumožňují únik výjimek jako odpověď na chybné vstupy. Jsou vyvolány a zachyceny (což umožňuje ladicím programům a monitorům zobrazit chybu), ale výjimka je potlačena a operace provede něco rozumného (obvykle nedělá nic).

Konstruktory

Activity(String)

Inicializuje novou instanci Activity třídy.

Vlastnosti

ActivityTraceFlags

Získá nebo nastaví příznaky (definované specifikací W3C ID) přidružené k aktivitě.

Baggage

Získá kolekci párů klíč/hodnota, která představuje informace předávané podřízeným položkám tohoto Activityobjektu .

Context

Získá kontext aktivity. Kontext se stává platným pouze v případě, že byla aktivita spuštěna.

Current

Získá nebo nastaví aktuální operaci (Activity) pro aktuální vlákno. Tok mezi asynchronními voláními.

DefaultIdFormat

Získá nebo nastaví výchozí formát ID pro Activity.

DisplayName

Získá nebo nastaví zobrazovaný název aktivity.

Duration

Získá dobu trvání operace.

Events

Získá seznam všech událostí aktivit připojených k této aktivitě.

ForceDefaultIdFormat

Získá nebo nastaví hodnotu, která detrminuje, pokud DefaultIdFormat se vždy používá k definování výchozího formátu ID.

HasRemoteParent

Získá hodnotu, která označuje, zda nadřazený kontext byl vytvořen ze vzdáleného šíření.

Id

Získá identifikátor, který je specifický pro konkrétní požadavek.

IdFormat

Získá formát pro Id.

IsAllDataRequested

Získá nebo nastaví hodnotu, která označuje, zda má být tato aktivita naplněna všemi informacemi o šíření, stejně jako všechny ostatní vlastnosti, jako jsou odkazy, značky a události.

IsStopped

Získá hodnotu, která označuje, zda je tento Activity objekt zastaven nebo ne.

Kind

Získá vztah mezi aktivitou, jejími nadřazenými a podřízenými položkami v trasování.

Links

Získá seznam všech propojení aktivit připojených k této aktivitě.

OperationName

Získá název operace.

Parent

Získá nadřazený Activity objekt, který vytvořil tuto aktivitu.

ParentId

Získá ID nadřazeného objektu této aktivity.

ParentSpanId

Získá nadřazený objekt SpanId.

Recorded

Získá hodnotu, která označuje, zda W3CIdFlags.Recorded příznak je nastaven.

RootId

Získá kořenové ID tohoto Activityobjektu .

Source

Získá zdroj aktivity přidružený k této aktivitě.

SpanId

Získá část SPAN souboru Id.

StartTimeUtc

Získá čas, kdy byla operace spuštěna.

Status

Získá stavový kód objektu aktuální aktivity.

StatusDescription

Získá popis stavu aktuální aktivity objektu.

TagObjects

Získá seznam značek, které představují informace, které se mají protokolovat spolu s aktivitou. Tyto informace se nepředávají podřízeným členům této aktivity.

Tags

Získá kolekci párů klíč/hodnota, které představují informace, které budou protokolovány spolu s Activity protokolovací systém.

TraceId

Získá traceId část .Id

TraceIdGenerator

Při spuštění aktivity, která nemá nadřazený kontext, se ID trasování automaticky vygeneruje pomocí náhodných čísel. TraceIdGenerator lze použít k přepsání výchozího algoritmu generování ID trasování modulu runtime.

TraceStateString

Získá nebo nastaví hlavičku W3C tracestate .

Metody

AddBaggage(String, String)

Activity Aktualizace nové zavazadlo se zadaným klíčem a hodnotou.

AddEvent(ActivityEvent)

Přidá zadanou událost aktivity do seznamu událostí.

AddException(Exception, TagList, DateTimeOffset)

Představuje operaci s kontextem, která se má použít k protokolování.

AddLink(ActivityLink)

Představuje operaci s kontextem, která se má použít k protokolování.

AddTag(String, Object)

Aktualizace aktivitu tak, aby měla značku s dalšími key a value.

AddTag(String, String)

Aktualizace mít Activity novou značku se zadanými key a value.

Dispose()

Zastaví aktivitu, pokud už je spuštěná, a upozorní všechny naslouchací procesy událostí. Jinak se nic nestane.

Dispose(Boolean)

Při přepsání odvozeným typem tato metoda uvolní všechny přidělené prostředky.

EnumerateEvents()

Vytvoří ActivityEvent výčet objektů připojených k tomuto objektu Activity.

EnumerateLinks()

Vytvoří ActivityLink výčet objektů připojených k tomuto objektu Activity.

EnumerateTagObjects()

Vytvoří výčet značek připojených k tomuto objektu Activity.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetBaggageItem(String)

Vrátí hodnotu páru klíč-hodnota přidanou k aktivitě pomocí AddBaggage(String, String)příkazu .

GetCustomProperty(String)

Vrátí objekt mapovaný na zadaný název vlastnosti.

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetTagItem(String)

Vrátí hodnotu značky Activity mapované na vstupní klíč. Vrátí, null pokud tento klíč neexistuje.

GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
SetBaggage(String, String)

Přidejte nebo aktualizujte zavazadlo Activity pomocí vstupního klíče a hodnoty. Pokud je null vstupní hodnota - pokud má kolekce nějaké zavazadlo se stejným klíčem, pak bude toto zavazadlo odebráno z kolekce. – jinak se nic nestane a kolekce se nezmění. Pokud vstupní hodnota není null – pokud má kolekce nějaké zavazadlo se stejným klíčem, pak se hodnota namapovaná na tento klíč aktualizuje o novou vstupní hodnotu. - jinak se klíč a hodnota přidají jako nové zavazadlo do kolekce. Položka zavazadla bude aktualizována nebo odebrána pouze v případě, že byla původně přidána k aktuální aktivitě. Položky zděděné od rodičů nebudou změněny ani odebrány, místo toho by se do aktuálního zavazadla aktivity přidala nová položka.

SetCustomProperty(String, Object)

Připojí k této aktivitě jakýkoliv vlastní objekt. Pokud byl zadaný propertyName objekt dříve přidružen k jinému objektu, bude tato vlastnost aktualizována tak, aby byla přidružena k novému propertyValue objektu. Doporučuje se použít jedinečný název vlastnosti, aby nedocházelo ke konfliktům s kýmkoli, kdo používá stejnou hodnotu.

SetEndTime(DateTime)

Activity Aktualizace nastavit jako Duration rozdíl mezi StartTimeUtc a zadaným časem zastavení.

SetIdFormat(ActivityIdFormat)

Nastaví formát Activity ID před jeho spuštěním.

SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)

Nastaví nadřazené ID pomocí konvence W3C traceId a SpanId.

SetParentId(String)

Aktualizace to Activity značí, že Activity to Activityzpůsobila hodnota s ID parentId .

SetStartTime(DateTime)

Nastaví čas zahájení tohoto Activitypříkazu .

SetStatus(ActivityStatusCode, String)

Nastaví stavový kód a popis aktuálního objektu aktivity.

SetTag(String, Object)

Přidá nebo aktualizuje značku aktivity pomocí vstupního klíče a hodnoty.

Start()

Spustí aktivitu.

Stop()

Zastaví aktivitu.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Událost

CurrentChanged

Nastane, když se Current hodnota změní.

Platí pro