Activity Osztály

Definíció

Névtér:

System.Diagnostics

Szerelvény:

System.Diagnostics.DiagnosticSource.dll

Csomag:

System.Diagnostics.DiagnosticSource v11.0.0-preview.5.26302.115

Forrás:

Activity.cs

A naplózáshoz használt kontextussal rendelkező műveletet reprezentálja.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Öröklődés

Object

Activity

Megvalósítás

IDisposable

Megjegyzések

A Activity művelet neve, azonosítója, kezdési időpontja és időtartama, címkéi és poggyásza.

Az aktuális tevékenység a statikus Activity.Current tulajdonsággal érhető el.

A tevékenységeket úgy kell létrehozni, hogy meghívja a konstruktort, szükség szerint konfigurálja, majd a Start metódussal kezdi, amely fenntartja a tevékenységek és csoportok Activity.Currentszülő-gyermek kapcsolatait.

Ha egy tevékenység befejeződött, azt le kell állítani a Activity.Stop() módszerrel.

Ha azonban megsemmisíti az Activity objektumot, az leállítja, így nem kell explicit módon meghívnia Activity.Stop(). Ez leegyszerűsíti a kódolási mintát. További információkért tekintse meg a metódust Dispose .

Egyetlen metódus sem Activity teszi lehetővé a kivételek kizárását a rossz bemenetekre adott válaszként. A rendszer eldobja és elkapja őket (ami lehetővé teszi a hibakeresők és a monitorok számára a hiba megtekintését), de a kivétel el van tiltva, és a művelet ésszerűt tesz (általában semmit sem tesz).

Konstruktorok

Name	Description
Activity(String)	Inicializálja a Activity osztály új példányát.

Tulajdonságok

Name	Description
ActivityTraceFlags	Lekéri vagy beállítja a tevékenységhez társított (a W3C-azonosító specifikációja által meghatározott) jelzőket.
Baggage	Lekéri a kulcs-/érték párok gyűjteményét, amelyek a gyermekeknek átadott információkat jelölik Activity.
Context	Lekéri a tevékenység kontextusát. A környezet csak akkor válik érvényessé, ha a tevékenység elindult.
Current	Lekéri vagy beállítja az aktuális szál aktuális műveletét (Activity). Ez az aszinkron hívások között zajlik.
DefaultIdFormat	Lekéri vagy beállítja az alapértelmezett azonosítóformátumot a Activity.
DisplayName	Lekéri vagy beállítja a tevékenység megjelenítendő nevét.
Duration	Lekéri a művelet időtartamát.
Events	Lekéri a tevékenységhez csatolt összes tevékenységesemény listáját.
ForceDefaultIdFormat	Lekéri vagy beállít egy olyan értéket, amely detrminál, ha az DefaultIdFormat mindig az alapértelmezett azonosítóformátum meghatározására szolgál.
HasRandomizedTraceId	A naplózáshoz használt kontextussal rendelkező műveletet reprezentálja.
HasRemoteParent	Olyan értéket kap, amely jelzi, hogy a szülőkörnyezet távoli propagálásból lett-e létrehozva.
Id	Egy adott kéréshez tartozó azonosítót kap.
IdFormat	Lekéri a formátumot a Id.
IsAllDataRequested	Lekéri vagy beállít egy értéket, amely jelzi, hogy a tevékenységet fel kell-e tölteni az összes propagálási információval, valamint az összes többi tulajdonsággal, például hivatkozásokkal, címkékkel és eseményekkel.
IsStopped	Olyan értéket kap, amely jelzi, hogy az Activity objektum le van-e állítva.
Kind	Nyomon követhető a kapcsolat a tevékenység, a szülők és a gyermekei között.
Links	Lekéri a tevékenységhez csatolt összes tevékenységhivatkozás listáját.
OperationName	Lekéri a művelet nevét.
Parent	Lekéri a tevékenységet létrehozó szülőt Activity .
ParentId	Lekéri a tevékenység szülőjének azonosítóját.
ParentSpanId	Lekéri a szülőét SpanId.
Recorded	Beolvas egy értéket, amely jelzi, hogy a W3CIdFlags.Recorded jelző be van-e állítva.
RootId	Lekéri ennek a gyökérazonosítóját Activity.
Source	Lekéri a tevékenységhez társított tevékenységforrást.
SpanId	Lekéri a SPAN részét a Id.
StartTimeUtc	Lekéri a művelet indításának időpontját.
Status	Lekéri az aktuális tevékenységobjektum állapotkódját.
StatusDescription	Lekéri az aktuális tevékenységobjektum állapotleírását.
TagObjects	Lekéri azoknak a címkéknek a listáját, amelyek a tevékenységgel együtt naplózandó információkat jelölnek. Ezt az információt a rendszer nem továbbítja ennek a tevékenységnek a gyermekeinek.
Tags	Lekéri a kulcs-/érték párok gyűjteményét, amelyek a naplózási rendszerbe naplózni Activity kívánt információkat jelölik.
TraceId	Lekéri a TraceId részét.Id
TraceIdGenerator	Ha olyan tevékenységet indít el, amely nem rendelkezik szülőkörnyezettel, a rendszer automatikusan véletlenszerű számokkal hozza létre a nyomkövetési azonosítót. A TraceIdGenerator segítségével felülbírálhatja a futtatókörnyezet alapértelmezett nyomkövetési azonosító-generálási algoritmusát.
TraceStateString	Lekéri vagy beállítja a W3C-fejlécet tracestate .

Metódusok

Name	Description
AddBaggage(String, String)	Frissíti az Activity új poggyászelemet a megadott kulccsal és értékkel.
AddEvent(ActivityEvent)	Hozzáadja a megadott tevékenységeseményt az események listájához.
AddException(Exception, TagList, DateTimeOffset)	Adjon hozzá egy ActivityEvent objektumot, amely a kivétel adatait tartalmazza a Events listához.
AddLink(ActivityLink)	Hozzáad egy ActivityLink elemet a Links listához.
AddTag(String, Object)	Frissíti a tevékenységet úgy, hogy egy további és valueegy további key címkével rendelkezzen.
AddTag(String, String)	Frissíti az Activity új címkét a megadott key és value.
Dispose()	Leállítja a tevékenységet, ha már elindult, és értesíti az eseményfigyelőket. Máskülönben semmi sem fog történni.
Dispose(Boolean)	Származtatott típusú felülbírálás esetén ez a metódus felszabadítja a lefoglalt erőforrásokat.
EnumerateEvents()	A tevékenységobjektumhoz csatolt objektumok számbavétele ActivityEvent .
EnumerateLinks()	A tevékenységobjektumhoz csatolt objektumok számbavétele ActivityLink .
EnumerateTagObjects()	A tevékenységobjektumhoz csatolt címkék számbavétele.
GetBaggageItem(String)	A tevékenységhez AddBaggage(String, String)hozzáadott kulcs-érték pár értékét adja vissza.
GetCustomProperty(String)	A megadott tulajdonságnévre leképezett objektumot adja vissza.
GetTagItem(String)	A bemeneti kulcshoz hozzárendelt tevékenységcímke értékét adja vissza. Visszaadja null , ha ez a kulcs nem létezik.
SetBaggage(String, String)	Adja hozzá vagy frissítse a tevékenység poggyászát a bemeneti kulccsal és az értékkel. Ha a bemeneti érték null - ha a gyűjtemény rendelkezik ugyanazzal a kulccsal rendelkező poggyászsal, akkor ez a poggyász el lesz távolítva a gyűjteményből. - ellenkező esetben semmi sem történik, és a gyűjtemény nem változik. Ha a bemeneti érték nem null – ha a gyűjtemény rendelkezik ugyanazzal a kulccsal ellátott poggyászsal, akkor az ehhez a kulcshoz hozzárendelt érték frissül az új bemeneti értékkel. - ellenkező esetben a kulcs és az érték új poggyászként lesz hozzáadva a gyűjteményhez. A poggyászelem csak akkor frissül/távolítható el, ha eredeti volt hozzáadva az aktuális tevékenységhez. A szülőktől örökölt elemeket nem módosítjuk/távolítjuk el, helyette új elemet adunk hozzá az aktuális tevékenységi poggyászhoz.
SetCustomProperty(String, Object)	Minden egyéni objektumot csatol ehhez a tevékenységhez. Ha a megadott propertyName korábban egy másik objektumhoz volt társítva, a tulajdonság frissül, hogy az újhoz propertyValue legyen társítva. Az azonos értéket használó személyekkel való ütközések elkerülése érdekében ajánlott egyedi tulajdonságnevet használni.
SetEndTime(DateTime)	Frissíti a ActivityDuration különbséget a megadott és a megadott leállítási idő között StartTimeUtc .
SetIdFormat(ActivityIdFormat)	Beállítja az azonosító formátumát a Activity kezdés előtt.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	A szülőazonosítót egy TraceId és egy SpanId W3C-konvencióval állítja be.
SetParentId(String)	Ezt frissíti Activity , hogy jelezze, hogy a Activity hiba oka az azonosítóval parentId együtt történt Activity.
SetStartTime(DateTime)	Ennek a kezdő időpontnak a Activitybeállítása.
SetStatus(ActivityStatusCode, String)	Beállítja az aktuális tevékenységobjektum állapotkódját és leírását.
SetTag(String, Object)	Hozzáadja vagy frissíti a tevékenységcímkét a bemeneti kulccsal és az értékkel.
Start()	Elindítja a tevékenységet.
Stop()	Leállítja a tevékenységet.

esemény

Name	Description
CurrentChanged	Akkor fordul elő, ha az Current érték megváltozik.