Activity Sınıf

Tanım

Günlük kaydı için kullanılacak bağlama sahip bir işlemi temsil eder.

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
Devralma
Activity
Uygulamalar

Açıklamalar

bir Activity işlem adı, kimlik, başlangıç zamanı ve süresi, etiketler ve bagaja sahiptir.

Geçerli etkinliğe statik Activity.Current özelliğiyle erişilebilir.

Etkinlikler oluşturucu çağrılarak oluşturulmalıdır, gerektiği şekilde yapılandırılmalıdır ve ardından etkinlikler ve kümeleri Activity.Currentiçin üst-alt ilişkileri koruyan yöntemiyle Start başlatılmalıdır.

Bir etkinlik tamamlandığında yöntemiyle Activity.Stop() durdurulmalıdır.

Ancak, nesnesini atarsanız Activity , açıkça çağırmanız Activity.Stop()gerekmeyecek şekilde durdurulur. Bu, kodlama düzenini basitleştirir. Daha fazla bilgi için yöntemine Dispose bakın.

Hiçbir Activity yöntem, hatalı girişlere yanıt olarak özel durumların kaçmasına izin vermez. Bunlar oluşturulur ve yakalanır (hata ayıklayıcıların ve izleyicilerin hatayı görmesine izin verir), ancak özel durum gizlenip işlem makul bir şey yapar (genellikle hiçbir şey yapmaz).

Oluşturucular

Activity(String)

Activity sınıfının yeni bir örneğini başlatır.

Özellikler

ActivityTraceFlags

Etkinlikle ilişkili bayrakları (W3C Kimliği belirtimi tarafından tanımlanır) alır veya ayarlar.

Baggage

Bu Activityöğesinin alt öğelerine geçirilen bilgileri temsil eden bir anahtar/değer çifti koleksiyonunu alır.

Context

Etkinliğin bağlamını alır. Bağlam yalnızca etkinlik başlatıldıysa geçerli olur.

Current

Geçerli iş parçacığı için geçerli işlemi (Activity) alır veya ayarlar. Bu, zaman uyumsuz çağrılar arasında akar.

DefaultIdFormat

için Activityvarsayılan kimlik biçimini alır veya ayarlar.

DisplayName

Etkinliğin görünen adını alır veya ayarlar.

Duration

İşlemin süresini alır.

Events

Bu etkinliğe eklenen tüm etkinlik olaylarının listesini alır.

ForceDefaultIdFormat

varsayılan kimlik biçimini tanımlamak için her zaman kullanılırsa DefaultIdFormat , detrmine değeri alır veya ayarlar.

HasRemoteParent

Üst bağlamın uzak yaymadan oluşturulup oluşturulmadığını gösteren bir değer alır.

Id

Belirli bir isteğe özgü bir tanımlayıcı alır.

IdFormat

için Idbiçimini alır.

IsAllDataRequested

Bu etkinliğin tüm yayma bilgileriyle ve bağlantılar, etiketler ve olaylar gibi diğer tüm özelliklerle doldurulup doldurulmayacağını belirten bir değer alır veya ayarlar.

IsStopped

Bu Activity nesnenin durdurulup durdurulmadığını belirten bir değer alır.

Kind

Bir izlemede etkinlik, üst öğeleri ve alt öğeleri arasındaki ilişkiyi alır.

Links

Bu etkinliğe eklenen tüm etkinlik bağlantılarının listesini alır.

OperationName

İşlem adını alır.

Parent

Bu etkinliği oluşturan üst öğeyi Activity alır.

ParentId

Bu etkinliğin üst öğesinin kimliğini alır.

ParentSpanId

Ebeveynin SpanIdöğesini alır.

Recorded

W3CIdFlags.Recorded bayrağının ayarlanıp ayarlanmadığını gösteren bir değer alır.

RootId

Bu Activityöğesinin kök kimliğini alır.

Source

Bu etkinlikle ilişkili etkinlik kaynağını alır.

SpanId

öğesinin SPAN bölümünü Idalır.

StartTimeUtc

İşlemin başladığı zamanı alır.

Status

Geçerli etkinlik nesnesinin durum kodunu alır.

StatusDescription

Geçerli etkinlik nesnesinin durum açıklamasını alır.

TagObjects

Etkinlikle birlikte günlüğe kaydedilecek bilgileri temsil eden etiketlerin listesini alır. Bu bilgiler bu etkinliğin alt öğelerine geçirilmemiştir.

Tags

Günlüğe kaydetme sistemiyle birlikte günlüğe kaydedilecek bilgileri temsil eden anahtar/değer çiftlerinden Activity oluşan bir koleksiyon alır.

TraceId

TraceId bölümünü Idalır.

TraceIdGenerator

Üst bağlamı olmayan bir Etkinliği başlatırken, İzleme Kimliği rastgele sayılar kullanılarak otomatik olarak oluşturulur. TraceIdGenerator, çalışma zamanının varsayılan İzleme Kimliği oluşturma algoritmasını geçersiz kılmak için kullanılabilir.

TraceStateString

W3C tracestate üst bilgisini alır veya ayarlar.

Yöntemler

AddBaggage(String, String)

Activity Belirtilen anahtar ve değere sahip yeni bir bagaj öğesinin olması için öğesini Güncelleştirmeler.

AddEvent(ActivityEvent)

Belirtilen etkinlik olayını olaylar listesine ekler.

AddException(Exception, TagList, DateTimeOffset)

Günlük kaydı için kullanılacak bağlama sahip bir işlemi temsil eder.

AddLink(ActivityLink)

Günlük kaydı için kullanılacak bağlama sahip bir işlemi temsil eder.

AddTag(String, Object)

Etkinliği ek ve valueetiketine sahip olacak şekilde key Güncelleştirmeler.

AddTag(String, String)

Activity sağlanan key ve valueile yeni bir etikete sahip olmak için öğesini Güncelleştirmeler.

Dispose()

Zaten başlatıldıysa etkinliği durdurur ve olay dinleyicilerine bildirir. Aksi halde hiçbir şey olmayacak.

Dispose(Boolean)

Türetilmiş bir tür tarafından geçersiz kılındığında, bu yöntem ayrılan tüm kaynakları serbest bırakır.

EnumerateEvents()

Bu Activity nesnesine ActivityEvent eklenmiş nesneleri numaralandırır.

EnumerateLinks()

Bu Activity nesnesine ActivityLink eklenmiş nesneleri numaralandırır.

EnumerateTagObjects()

Bu Activity nesnesine eklenen etiketleri numaralandırır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetBaggageItem(String)

ile AddBaggage(String, String)etkinliğine eklenen anahtar-değer çiftinin değerini döndürür.

GetCustomProperty(String)

Belirtilen özellik adına eşlenen nesneyi döndürür.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetTagItem(String)

Giriş anahtarıyla eşlenen Etkinlik etiketinin değerini döndürür. Bu anahtar yoksa döndürür null .

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
SetBaggage(String, String)

Etkinlik bagajını giriş anahtarı ve değeriyle ekleyin veya güncelleştirin. Giriş değeri ise null - koleksiyonda aynı anahtara sahip bir bagaj varsa, bu bagaj koleksiyondan kaldırılır. - aksi takdirde hiçbir şey olmaz ve koleksiyon değişmez. Giriş değeri değilse null - koleksiyonda aynı anahtara sahip bir bagaj varsa, bu anahtarla eşlenen değer yeni giriş değeriyle güncelleştirilir. - aksi takdirde anahtar ve değer koleksiyona yeni bir bagaj olarak eklenir. Bagaj eşyası yalnızca orijinal olarak geçerli etkinliğe eklenmişse güncelleştirilecek/kaldırılacaktır. Ebeveynlerden devralınan öğeler değiştirilmez/kaldırılmaz, bunun yerine geçerli etkinlik bagajına yeni öğe eklenir.

SetCustomProperty(String, Object)

Bu etkinliğe herhangi bir özel nesne ekler. Belirtilen propertyName daha önce başka bir nesneyle ilişkilendirildiyse, özellik bunun yerine yeni propertyValue nesneyle ilişkilendirilecek şekilde güncelleştirilir. Aynı değeri kullanan herkesle çakışmaları önlemek için benzersiz bir özellik adı kullanmanız önerilir.

SetEndTime(DateTime)

Activity ve belirtilen durdurma süresi arasındaki StartTimeUtc fark olarak ayarlamak Duration için öğesini Güncelleştirmeler.

SetIdFormat(ActivityIdFormat)

Başlatılmadan önce kimlik biçimini ayarlar Activity .

SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)

TraceId ve SpanId'nin W3C kuralını kullanarak üst kimliği ayarlar.

SetParentId(String)

kimliğine parentId sahip öğesinin buna neden olduğunu Activity belirtmek için bunu ActivityActivityGüncelleştirmeler.

SetStartTime(DateTime)

Bu Activityöğesinin başlangıç saatini ayarlar.

SetStatus(ActivityStatusCode, String)

Geçerli etkinlik nesnesinde durum kodunu ve açıklamasını ayarlar.

SetTag(String, Object)

Etkinlik etiketini giriş anahtarı ve değeriyle ekler veya güncelleştirir.

Start()

Etkinliği başlatır.

Stop()

Etkinliği durdurur.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Ekinlikler

CurrentChanged

Değer değiştiğinde Current gerçekleşir.

Şunlara uygulanır