DispatchRuntime Kelas

Definisi

Ruang nama:

System.ServiceModel.Dispatcher

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Sumber:

DispatchRuntime.cs

Mengekspos properti yang dapat digunakan untuk memodifikasi perilaku layanan default serta melampirkan objek kustom yang dapat memodifikasi bagaimana pesan masuk diubah menjadi objek dan dikirim ke operasi. Kelas ini tidak dapat diwariskan.

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Warisan

Object

DispatchRuntime

Keterangan

DispatchRuntime Gunakan kelas baik untuk mengubah perilaku default layanan atau titik akhir individual, atau untuk menyisipkan objek yang mengimplementasikan modifikasi kustom ke salah satu atau kedua proses layanan berikut:

1. Transformasi pesan masuk menjadi objek dan merilis objek tersebut sebagai pemanggilan metode pada objek layanan.

2. Transformasi objek yang diterima dari respons terhadap pemanggilan operasi layanan menjadi pesan keluar.

Di Windows Communication Foundation (WCF), dispatcher saluran dan titik akhir adalah komponen layanan yang bertanggung jawab untuk menerima saluran baru, menerima pesan, pengiriman metode dan pemanggilan, dan pemrosesan respons. Setiap titik akhir yang ServiceHost diekspos oleh objek memiliki satu dispatcher titik akhir dan dispatcher saluran terkait; selain itu, setiap klien yang berpartisipasi dalam komunikasi dupleks juga memiliki dispatcher titik akhir dan dispatcher saluran untuk setiap titik akhir panggilan balik.

DispatchRuntime memungkinkan Anda untuk mencegat dan memperluas dispatcher saluran atau titik akhir untuk semua pesan di seluruh kontrak tertentu, bahkan saat pesan tidak dikenali. Ketika pesan tiba yang tidak cocok dengan pesan apa pun yang dinyatakan dalam kontrak, pesan dikirim ke operasi yang dikembalikan oleh UnhandledDispatchOperation properti . Untuk mencegat atau memperluas semua pesan untuk operasi tertentu, lihat kelas DispatchOperation.

Ada empat area utama ekstensibilitas dispatcher yang diekspos oleh kelas DispatchRuntime:

1. Komponen pengiriman menggunakan properti dan DispatchRuntime yang dari dispatcher saluran terkait yang dikembalikan oleh ChannelDispatcher properti untuk menyesuaikan bagaimana dispatcher saluran menerima dan menutup saluran. Kategori ini mencakup properti ChannelInitializers dan InputSessionShutdownHandlers.

2. Komponen pesan dikustomisasi untuk setiap pesan yang diproses. Kategori ini mencakup properti MessageInspectors, OperationSelector, Operations, dan ErrorHandlers.

3. Komponen instans menyesuaikan pembuatan, masa pakai, dan pembuangan instans dari jenis layanan. Untuk informasi selengkapnya tentang masa pakai objek layanan, lihat properti InstanceContextMode. Kategori ini mencakup properti InstanceContextInitializers dan InstanceProvider.

4. Komponen terkait keamanan dapat menggunakan properti berikut:

   • SecurityAuditLogLocation menunjukkan tempat peristiwa audit ditulis.

   • ImpersonateCallerForAllOperations mengontrol apakah layanan mencoba menyamar menggunakan mandat yang disediakan oleh pesan masuk.

   • MessageAuthenticationAuditLevel mengontrol apakah peristiwa autentikasi pesan yang berhasil, ditulis ke log peristiwa yang ditentukan oleh SecurityAuditLogLocation.

   • PrincipalPermissionMode mengontrol bagaimana properti CurrentPrincipal diatur.

   • ServiceAuthorizationAuditLevel menentukan bagaimana audit peristiwa otorisasi dilakukan.

   • SuppressAuditFailure menentukan apakah akan menekan pengecualian non-kritis yang terjadi selama proses pengelogan.

Biasanya objek ekstensi kustom ditetapkan ke properti atau dimasukkan ke DispatchRuntime dalam koleksi oleh perilaku layanan (objek yang mengimplementasikan IServiceBehavior), perilaku kontrak (objek yang mengimplementasikan IContractBehavior), atau perilaku titik akhir (objek yang mengimplementasikan IEndpointBehavior). Kemudian objek perilaku penginstalan ditambahkan ke koleksi perilaku yang sesuai baik secara terprogram maupun dengan menerapkan objek BehaviorExtensionElement kustom untuk memungkinkan perilaku dimasukkan menggunakan file konfigurasi aplikasi.

Properti

ChannelDispatcher	ChannelDispatcher Mendapatkan untuk objek run-time pengiriman ini.
MessageInspectors	Mendapatkan kumpulan IDispatchMessageInspector objek yang dapat digunakan untuk melampirkan pemeriksa pesan kustom untuk semua pesan masuk dan keluar di seluruh titik akhir.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)