Activity Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.DiagnosticSource.dll

Balíček:

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

Zdroj:

Activity.cs

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

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Dědičnost

Object

Activity

Implementuje

IDisposable

Poznámky

Má 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í.