Activity Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.DiagnosticSource.dll

Paket:

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

Sumber:

Activity.cs

Merepresentasikan suatu operasi beserta konteks yang digunakan untuk pencatatan log.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Warisan

Object

Activity

Penerapan

IDisposable

Keterangan

Memiliki Activity nama operasi, ID, waktu mulai dan durasi, tag, dan bagasi.

Aktivitas saat ini dapat diakses dengan properti statis Activity.Current .

Aktivitas harus dibuat dengan memanggil konstruktor, dikonfigurasi seperlunya, dan kemudian dimulai dengan Start metode , yang mempertahankan hubungan induk-anak untuk aktivitas dan set Activity.Current.

Ketika aktivitas selesai, aktivitas harus dihentikan dengan Activity.Stop() metode .

Namun, jika Anda membuang Activity objek, yang menghentikannya sehingga Anda tidak perlu secara eksplisit memanggil Activity.Stop(). Itu menyederhanakan pola pengkodian. Untuk informasi selengkapnya, lihat metode Dispose.

Tidak ada Activity metode yang memungkinkan pengecualian untuk lolos sebagai respons terhadap input yang buruk. Mereka dilemparkan dan ditangkap (yang memungkinkan debugger dan monitor untuk melihat kesalahan), tetapi pengecualian ditekan, dan operasi melakukan sesuatu yang wajar (biasanya tidak melakukan apa-apa).

Konstruktor

Nama	Deskripsi
Activity(String)	Menginisialisasi instans baru dari kelas Activity.

Properti

Nama	Deskripsi
ActivityTraceFlags	Mendapatkan atau mengatur bendera (ditentukan oleh spesifikasi ID W3C) yang terkait dengan aktivitas.
Baggage	Mendapatkan kumpulan pasangan kunci/nilai yang mewakili informasi yang diteruskan ke turunan dari ini Activity.
Context	Mendapatkan konteks aktivitas. Konteks menjadi valid hanya jika aktivitas telah dimulai.
Current	Mendapatkan atau mengatur operasi saat ini (Activity) untuk utas saat ini. Ini mengalir di seluruh panggilan asinkron.
DefaultIdFormat	Mendapatkan atau mengatur format ID default untuk Activity.
DisplayName	Mendapatkan atau mengatur nama tampilan aktivitas.
Duration	Mendapatkan durasi operasi.
Events	Mendapatkan daftar semua peristiwa aktivitas yang dilampirkan ke aktivitas ini.
ForceDefaultIdFormat	Mendapatkan atau menetapkan nilai yang mendetrminasi jika DefaultIdFormat selalu digunakan untuk menentukan format ID default.
HasRandomizedTraceId	Merepresentasikan suatu operasi beserta konteks yang digunakan untuk pencatatan log.
HasRemoteParent	Mendapatkan nilai yang menunjukkan apakah konteks induk dibuat dari penyebaran jarak jauh.
Id	Mendapatkan pengidentifikasi yang khusus untuk permintaan tertentu.
IdFormat	Mendapatkan format untuk Id.
IsAllDataRequested	Mendapatkan atau menetapkan nilai yang menunjukkan apakah aktivitas ini harus diisi dengan semua informasi penyebaran, serta semua properti lainnya, seperti tautan, tag, dan peristiwa.
IsStopped	Mendapatkan nilai yang menunjukkan apakah objek ini Activity dihentikan atau tidak.
Kind	Mendapatkan hubungan antara aktivitas, orang tuanya, dan anak-anaknya dalam jejak.
Links	Mendapatkan daftar semua tautan aktivitas yang dilampirkan ke aktivitas ini.
OperationName	Mendapatkan nama operasi.
Parent	Mendapatkan induk Activity yang membuat aktivitas ini.
ParentId	Mendapatkan ID induk aktivitas ini.
ParentSpanId	Mendapatkan induknya SpanId.
Recorded	Mendapatkan nilai yang menunjukkan apakah bendera W3CIdFlags.Recorded diatur.
RootId	Mendapatkan ID akar dari .Activity
Source	Mendapatkan sumber aktivitas yang terkait dengan aktivitas ini.
SpanId	Mendapatkan bagian SPAN dari Id.
StartTimeUtc	Mendapatkan waktu ketika operasi dimulai.
Status	Mendapatkan kode status objek aktivitas saat ini.
StatusDescription	Mendapatkan deskripsi status objek aktivitas saat ini.
TagObjects	Mendapatkan daftar tag yang mewakili informasi untuk dicatat bersama dengan aktivitas. Informasi ini tidak diteruskan kepada anak-anak dari aktivitas ini.
Tags	Mendapatkan kumpulan pasangan kunci/nilai yang mewakili informasi yang akan dicatat bersama dengan Activity sistem pengelogan.
TraceId	Mendapatkan bagian TraceId dari Id.
TraceIdGenerator	Saat memulai Aktivitas yang tidak memiliki konteks induk, Id Jejak akan secara otomatis dihasilkan menggunakan angka acak. TraceIdGenerator dapat digunakan untuk mengambil alih algoritma pembuatan Trace Id default runtime.
TraceStateString	Mendapatkan atau mengatur header W3C tracestate .

Metode

Nama	Deskripsi
AddBaggage(String, String)	Activity Memperbarui untuk memiliki item bagasi baru dengan kunci dan nilai yang ditentukan.
AddEvent(ActivityEvent)	Menambahkan peristiwa aktivitas yang ditentukan ke daftar peristiwa.
AddException(Exception, TagList, DateTimeOffset)	Tambahkan objek yang ActivityEvent berisi informasi pengecualian ke Events daftar.
AddLink(ActivityLink)	ActivityLink Menambahkan ke Links daftar.
AddTag(String, Object)	Memperbarui aktivitas untuk memiliki tag dengan tambahan key dan value.
AddTag(String, String)	Activity Memperbarui untuk memiliki tag baru dengan yang disediakan key dan value.
Dispose()	Menghentikan aktivitas jika sudah dimulai dan memberi tahu pendengar peristiwa apa pun. Tidak ada yang akan terjadi sebaliknya.
Dispose(Boolean)	Ketika ditimpa oleh jenis turunan, metode ini merilis sumber daya apa pun yang dialokasikan.
EnumerateEvents()	Menghitung objek yang ActivityEvent dilampirkan ke objek Aktivitas ini.
EnumerateLinks()	Menghitung objek yang ActivityLink dilampirkan ke objek Aktivitas ini.
EnumerateTagObjects()	Menghitung tag yang dilampirkan ke objek Aktivitas ini.
GetBaggageItem(String)	Mengembalikan nilai pasangan kunci-nilai yang ditambahkan ke aktivitas dengan AddBaggage(String, String).
GetCustomProperty(String)	Mengembalikan objek yang dipetakan ke nama properti yang ditentukan.
GetTagItem(String)	Mengembalikan nilai tag Aktivitas yang dipetakan ke kunci input. Mengembalikan null jika kunci tersebut tidak ada.
SetBaggage(String, String)	Tambahkan atau perbarui Bagasi aktivitas dengan kunci dan nilai input. Jika nilai input adalah null - jika koleksi memiliki bagasi dengan kunci yang sama, maka bagasi ini akan dihapus dari koleksi. - Jika tidak, tidak ada yang akan terjadi dan koleksi tidak akan berubah. Jika nilai input tidak null - jika koleksi memiliki bagasi dengan kunci yang sama, maka nilai yang dipetakan ke kunci ini akan diperbarui dengan nilai input baru. - jika tidak, kunci dan nilai akan ditambahkan sebagai bagasi baru ke koleksi. Item bagasi akan diperbarui/dihapus hanya jika aslinya ditambahkan ke aktivitas saat ini. Item yang diwariskan dari induk tidak akan diubah/dihapus, item baru akan ditambahkan ke bagasi aktivitas saat ini sebagai gantinya.
SetCustomProperty(String, Object)	Melampirkan objek kustom apa pun ke aktivitas ini. Jika yang ditentukan propertyName sebelumnya dikaitkan dengan objek lain, properti akan diperbarui untuk dikaitkan dengan yang baru propertyValue sebagai gantinya. Disarankan untuk menggunakan nama properti unik untuk menghindari konflik dengan siapa pun yang menggunakan nilai yang sama.
SetEndTime(DateTime)	Activity Memperbarui untuk mengaturnya Duration sebagai perbedaan antara StartTimeUtc dan waktu berhenti yang ditentukan.
SetIdFormat(ActivityIdFormat)	Menyetel format ID pada ini Activity sebelum dimulai.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	Mengatur ID induk menggunakan konvensi W3C dari TraceId dan SpanId.
SetParentId(String)	Perbarui ini Activity untuk menunjukkan bahwa Activity dengan ID penyebab parentId ini Activity.
SetStartTime(DateTime)	Mengatur waktu mulai ini Activity.
SetStatus(ActivityStatusCode, String)	Mengatur kode status dan deskripsi pada objek aktivitas saat ini.
SetTag(String, Object)	Menambahkan atau memperbarui tag aktivitas dengan kunci dan nilai input.
Start()	Memulai aktivitas.
Stop()	Menghentikan aktivitas.

Acara

Nama	Deskripsi
CurrentChanged	Terjadi ketika Current nilai berubah.