Activity Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.DiagnosticSource.dll

Paket:

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

Kaynak:

Activity.cs

Günlüğe kaydetmede kullanılacak bağlam içeren bir işlemi temsil eder.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Devralma

Object

Activity

Uygulamalar

IDisposable

Açıklamalar

bir Activity işlem adına, kimliğine, başlangıç zamanına ve süresine, etiketlere 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 bkz. Dispose yöntemi.

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 olanak tanır), ancak özel durum gizlenip işlem makul bir şey yapar (genellikle hiçbir şey yapmaz).

Oluşturucular

Name	Description
Activity(String)	Activity sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
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 anahtar/değer çiftleri 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 eden bir değer alır veya ayarlar.
HasRandomizedTraceId	Günlüğe kaydetmede kullanılacak bağlam içeren bir işlemi temsil eder.
HasRemoteParent	Üst bağlamın uzak yayılmadan 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 bilgilerinin yanı sıra 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ı gösteren bir değer alır.
Kind	Etkinlik, üst öğeleri ve alt öğeleri arasındaki ilişkiyi bir izde 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 aktarılmaz.
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

Name	Description
AddBaggage(String, String)	Activity öğesini belirtilen anahtar ve değere sahip yeni bir bagaja sahip olacak şekilde güncelleştirir.
AddEvent(ActivityEvent)	Belirtilen etkinlik olayını olaylar listesine ekler.
AddException(Exception, TagList, DateTimeOffset)	Özel durum bilgilerini Events içeren bir ActivityEvent nesneyi listeye ekleyin.
AddLink(ActivityLink)	Listeye bir ActivityLinkLinks ekler.
AddTag(String, Object)	Etkinliği ek key ve valueile bir etikete sahip olacak şekilde güncelleştirir.
AddTag(String, String)	öğesini Activity sağlanan key ve valueile yeni bir etikete sahip olacak şekilde güncelleştirir.
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 kaynakları serbest bırakır.
EnumerateEvents()	Bu Activity nesnesine ActivityEvent eklenen nesneleri numaralandırır.
EnumerateLinks()	Bu Activity nesnesine ActivityLink eklenen nesneleri numaralandırır.
EnumerateTagObjects()	Bu Activity nesnesine eklenen etiketleri numaralandırır.
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.
GetTagItem(String)	Giriş anahtarına eşlenen Etkinlik etiketinin değerini döndürür. Bu anahtar yoksa döndürür null .
SetBaggage(String, String)	Etkinlik bagajını giriş anahtarı ve değeriyle ekleyin veya güncelleştirin. Giriş değeri ise null - koleksiyonun 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 anahtara eşlenen değer yeni giriş değeriyle güncelleştirilir. - aksi takdirde anahtar ve değer koleksiyona yeni bir bagaj olarak eklenir. Bagaj öğesi yalnızca orijinal olarak geçerli etkinliğe eklenmişse güncelleştirilecek/kaldırılacaktır. Ebeveynden 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, özelliği 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 ile belirtilen durdurma süresi arasındaki StartTimeUtc fark olarak ayarlamak Duration için öğesini güncelleştirir.
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 Activity sahip parentId öğesinin buna neden olduğunu Activity belirtmek için bunu Activitygüncelleştirir.
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.

Ekinlikler

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