DispatchRuntime Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Dispatcher

Bütünleştirilmiş Kodlar:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v10.0.652802

Kaynak:

DispatchRuntime.cs

Varsayılan hizmet davranışını değiştirmek ve gelen iletilerin nesnelere dönüştürülme ve işlemlere gönderilmesini değiştirebilecek özel nesneler eklemek için kullanılabilecek özellikleri kullanıma sunar. Bu sınıf devralınamaz.

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Devralma

Object

DispatchRuntime

Açıklamalar

DispatchRuntime Bir hizmetin veya tek bir uç noktanın varsayılan davranışını değiştirmek ya da aşağıdaki hizmet işlemlerinden birine veya her ikisine özel değişiklikler uygulayan nesneler eklemek için sınıfını kullanın:

1. Gelen iletilerin nesnelere dönüştürülmesi ve bu nesnelerin bir hizmet nesnesi üzerinde yöntem çağrıları olarak serbest bırakılması.

2. Yanıttan alınan nesnelerin bir hizmet işlemi çağrısına çıkış mesajlarına dönüştürülmesi.

Windows Communication Foundation'da (WCF), kanal ve uç nokta dağıtıcıları yeni kanalları kabul etme, iletileri alma, yöntem dağıtma ve çağırma ve yanıt işlemeden sorumlu hizmet bileşenleridir. Bir ServiceHost nesne tarafından kullanıma sunulan her uç noktanın bir uç nokta dağıtıcısı ve ilişkili kanal dağıtıcısı vardır; buna ek olarak, çift yönlü iletişime katılan her istemcinin her geri çağırma uç noktası için bir uç nokta dağıtıcısı ve kanal dağıtıcısı da vardır.

, DispatchRuntime bir ileti tanınmadığında bile belirli bir sözleşmedeki tüm iletiler için kanalı veya uç nokta dağıtıcısını kesmenize ve genişletmenize olanak tanır. Sözleşmede bildirilen hiçbir iletiyle eşleşmeyen bir ileti geldiğinde, özelliği tarafından UnhandledDispatchOperation döndürülen işleme gönderilir. Belirli bir operasyonun tüm iletilerine müdahale etmek veya genişletmek için DispatchOperation sınıfına bakın.

Sınıfı tarafından DispatchRuntime kullanıma sunulan dört ana dağıtıcı genişletilebilirliği alanı vardır:

1. Dağıtım bileşenleri, kanal dağıtıcısının DispatchRuntime kanalları kabul etme ve kapatma biçimini özelleştirmek için özelliği tarafından ChannelDispatcher döndürülen ilişkili kanal dağıtıcısının ve özelliklerini kullanır. Bu kategori ve ChannelInitializersInputSessionShutdownHandlers özelliklerini içerir.

2. İleti bileşenleri işlenen her ileti için özelleştirilir. Bu kategori , , MessageInspectorsOperationSelectorve Operations özelliklerini içerirErrorHandlers.

3. Örnek bileşenleri, hizmet türünün örneklerinin oluşturulmasını, kullanım ömrünü ve atılmasını özelleştirir. Hizmet nesnesi yaşam süreleri hakkında daha fazla bilgi için özellik InstanceContextMode kısmına bakın. Bu kategori ve InstanceContextInitializersInstanceProvider özelliklerini içerir.

4. Güvenlikle ilgili bileşenler aşağıdaki özellikleri kullanabilir:

   • SecurityAuditLogLocation denetim olaylarının yazıldığı yeri gösterir.

   • ImpersonateCallerForAllOperations hizmetin gelen ileti tarafından sağlanan kimlik bilgilerini kullanarak kimliğine bürünmeye çalışıp çalışmayacağını denetler.

   • MessageAuthenticationAuditLevel , başarılı ileti kimlik doğrulaması olaylarının tarafından SecurityAuditLogLocationbelirtilen olay günlüğüne yazıp yazılmayacağını denetler.

   • PrincipalPermissionMode özelliğin CurrentPrincipal ayarlanma sürecini kontrol eder.

   • ServiceAuthorizationAuditLevel yetkilendirme olaylarının denetiminin nasıl gerçekleştirildiğini belirtir.

   • SuppressAuditFailure , günlüğe kaydetme işlemi sırasında oluşan kritik olmayan özel durumların gizlenip gizlenmeyeceğini belirtir.

Genellikle özel uzantı nesneleri bir DispatchRuntime özelliğe atanır veya bir hizmet davranışı (uygulayan IServiceBehaviorbir nesne), bir sözleşme davranışı (uygulayan IContractBehaviornesne) veya bir uç nokta davranışı (uygulayan IEndpointBehaviorbir nesne) tarafından bir koleksiyona eklenir. Ardından, yükleme davranışı nesnesi program aracılığıyla veya bir uygulama yapılandırma dosyası kullanılarak eklenmesini sağlamak için özel BehaviorExtensionElement bir nesne uygulanarak uygun davranış koleksiyonuna eklenir.

Özellikler

Name	Description
ChannelDispatcher	Bu dağıtım çalışma zamanı nesnesinin öğesini ChannelDispatcher alır.
MessageInspectors	Uç nokta boyunca tüm gelen ve giden iletiler için özel ileti denetçisi eklemek için kullanılabilecek bir nesne koleksiyonu IDispatchMessageInspector alır.