TrackingService Kelas

Definisi

Ruang nama:

System.Workflow.Runtime.Tracking

Rakitan:

System.Workflow.Runtime.dll

Perhatian

The System.Workflow.* types are deprecated. Instead, please use the new types from System.Activities.*

Menyediakan antarmuka dasar antara layanan pelacakan dan infrastruktur pelacakan run-time.

public ref class TrackingService abstract : System::Workflow::Runtime::Hosting::WorkflowRuntimeService

[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public abstract class TrackingService : System.Workflow.Runtime.Hosting.WorkflowRuntimeService

[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type TrackingService = class
    inherit WorkflowRuntimeService

Public MustInherit Class TrackingService
Inherits WorkflowRuntimeService

Warisan

Object

WorkflowRuntimeService

TrackingService

Turunan

System.Workflow.Runtime.Tracking.SqlTrackingService

Atribut

ObsoleteAttribute

Keterangan

Catatan

Materi ini membahas jenis dan namespace layanan yang sudah tidak digunakan. Untuk informasi selengkapnya, lihat Tipe Yang Tidak Digunakan Lagi di Windows Workflow Foundation 4.5.

Layanan pelacakan bertanggung jawab untuk memasok saluran pelacakan dan melacak profil ke mesin run-time alur kerja. Mesin run-time alur kerja meminta satu TrackingChannel dari layanan pelacakan untuk setiap instans alur kerja yang memiliki TrackingProfile. Mesin run-time alur kerja menggunakan ini TrackingChannel untuk mengirim rekaman pelacakan yang terkait dengan instans alur kerja tersebut. TrackingProfile berisi titik trek yang menentukan serangkaian peristiwa pelacakan yang infrastruktur pelacakan run-time-nya harus mengirim rekaman pelacakan. TrackingProfile mungkin juga menentukan data yang akan diekstrak dari instans alur kerja ketika salah satu peristiwa pelacakan ini terjadi.

Infrastruktur pelacakan run-time menggunakan TrackingProfile untuk memfilter peristiwa pelacakan yang dipancarkan oleh instans alur kerja. Saat peristiwa pelacakan dipancarkan yang cocok dengan titik trek di TrackingProfile, infrastruktur pelacakan run-time mengekstrak data apa pun yang ditentukan dalam TrackingProfile dari instans alur kerja dan merangkum data ini dan informasi tentang peristiwa pelacakan dalam rekaman pelacakan. Rekaman pelacakan ini kemudian dikirim melalui instans alur kerja yang TrackingChannel terkait. Rekaman pelacakan mungkin salah satu jenis berikut:

ActivityTrackingRecord

UserTrackingRecord

WorkflowTrackingRecord

Aplikasi host dapat menggunakan rekaman pelacakan dengan cara apa pun yang dipilihnya. Misalnya, aplikasi host dapat menyimpan informasi pelacakan dalam database dan menggunakannya untuk mengimplementasikan antarmuka pengguna yang canggih, atau dapat menggunakan informasi untuk memberi tahu administrator tentang kondisi yang memerlukan beberapa tindakan. Anda dapat mendaftarkan layanan pelacakan dengan mesin run-time alur kerja dengan memanggil WorkflowRuntime.AddService atau dengan menyertakan entri yang sesuai dalam file konfigurasi aplikasi.

Semua layanan pelacakan harus diwarisi dari TrackingService kelas abstrak. Kelas ini mendefinisikan antarmuka dasar antara layanan pelacakan dan infrastruktur pelacakan run-time. Mesin run-time alur kerja meminta instans TrackingProfile alur kerja atau alur Type kerja tertentu dengan memanggil salah satu metode yang kelebihan beban GetProfile atau TryGetProfile metode . Mesin run-time alur kerja memanggil GetTrackingChannel untuk meminta TrackingChannel.

Runtime pelacakan alur kerja memanggil GetProfile metode dan TryGetProfile setiap kali instans alur kerja dibuat atau dimuat dari penyimpanan persistensi. Overhead yang terkait dengan panggilan ini dapat mahal untuk layanan pelacakan (banyak panggilan database, misalnya). Anda dapat menerapkan IProfileNotification antarmuka dalam layanan pelacakan Anda untuk menghindari mekanisme berbasis panggilan ini dan menggunakan peristiwa untuk memberi tahu mesin runtime alur kerja tentang perubahan pada TrackingProfile. Untuk layanan pelacakan yang mengimplementasikan IProfileNotification antarmuka, mesin run-time alur kerja berlangganan ProfileUpdated peristiwa dan ProfileRemoved . Layanan pelacakan Anda dapat menaikkan peristiwa yang sesuai saat perubahan pada salah satu profil pelacakannya terjadi. Kelas SqlTrackingService mengimplementasikan antarmuka ini.

Mesin run-time alur kerja memanggil TryReloadProfile metode untuk menguji apakah TrackingProfile telah diperbarui atau dihapus sebagai akibat dari panggilan eksplisit oleh host atau layanan ke ReloadTrackingProfiles pada instans alur kerja. Proses ini memungkinkan host atau layanan untuk secara dinamis mengubah profil pelacakan yang digunakan untuk instans alur kerja tertentu.

Catatan Bagi Implementer

• Saat mewarisi dari TrackingService, Anda harus mengambil alih anggota berikut: GetProfile(Guid)

• GetProfile(Type, Version)

• TryGetProfile(Type, TrackingProfile)

• GetTrackingChannel(TrackingParameters)

• TryReloadProfile(Type, Guid, TrackingProfile)

Konstruktor

TrackingService()

Kedaluwarsa. Saat diimplementasikan di kelas turunan, menginisialisasi instans TrackingService baru kelas.

Properti

Runtime	Kedaluwarsa. WorkflowRuntime Mendapatkan untuk layanan ini. (Diperoleh dari WorkflowRuntimeService)
State	Kedaluwarsa. Mendapatkan status WorkflowRuntimeService. (Diperoleh dari WorkflowRuntimeService)

Metode

Equals(Object)	Kedaluwarsa. Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Kedaluwarsa. Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProfile(Guid)	Kedaluwarsa. Harus ditimpa di kelas turunan, dan ketika diimplementasikan, mengembalikan profil pelacakan untuk instans alur kerja yang ditentukan.
GetProfile(Type, Version)	Kedaluwarsa. Harus ditimpa di kelas turunan, dan ketika diimplementasikan, mengembalikan profil pelacakan, memenuhi syarat berdasarkan versi, untuk alur Typekerja yang ditentukan.
GetTrackingChannel(TrackingParameters)	Kedaluwarsa. Harus ditimpa di kelas turunan, dan ketika diimplementasikan, mengembalikan saluran yang digunakan infrastruktur pelacakan run-time untuk mengirim rekaman pelacakan ke layanan pelacakan.
GetType()	Kedaluwarsa. Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Kedaluwarsa. Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnStarted()	Kedaluwarsa. Ketika ditimpa di kelas turunan, mewakili metode yang akan dipanggil ketika mesin runtime alur kerja menaikkan Started peristiwa. (Diperoleh dari WorkflowRuntimeService)
OnStopped()	Kedaluwarsa. Ketika ditimpa di kelas turunan, mewakili metode yang akan dipanggil ketika mesin runtime alur kerja menaikkan Stopped peristiwa. (Diperoleh dari WorkflowRuntimeService)
RaiseServicesExceptionNotHandledEvent(Exception, Guid)	Kedaluwarsa. Memunculkan kejadian ServicesExceptionNotHandled. (Diperoleh dari WorkflowRuntimeService)
Start()	Kedaluwarsa. Ketika ditimpa di kelas turunan, memulai layanan dan mengubah ke StateStarting. (Diperoleh dari WorkflowRuntimeService)
Stop()	Kedaluwarsa. Ketika ditimpa di kelas turunan, menghentikan layanan dan mengubah ke StateStopping. (Diperoleh dari WorkflowRuntimeService)
ToString()	Kedaluwarsa. Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TryGetProfile(Type, TrackingProfile)	Kedaluwarsa. Harus ditimpa di kelas turunan, dan ketika diimplementasikan, mengambil profil pelacakan untuk jenis alur kerja yang ditentukan jika tersedia.
TryReloadProfile(Type, Guid, TrackingProfile)	Kedaluwarsa. Harus ditimpa di kelas turunan, dan ketika diimplementasikan, mengambil profil pelacakan baru untuk instans alur kerja yang ditentukan jika profil pelacakan telah berubah sejak terakhir kali dimuat.

Lihat juga

• IProfileNotification