DispatchRuntime Osztály

Definíció

Névtér:

System.ServiceModel.Dispatcher

Szerelvények:

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

Csomag:

System.ServiceModel.Primitives v10.0.652802

Forrás:

DispatchRuntime.cs

Olyan tulajdonságokat tesz elérhetővé, amelyek felhasználhatók az alapértelmezett szolgáltatás viselkedésének módosítására, valamint egyéni objektumok csatolására, amelyek módosíthatják a bejövő üzenetek objektummá alakítási és a műveletekhez való továbbítását. Ez az osztály nem örökölhető.

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Öröklődés

Object

DispatchRuntime

Megjegyzések

DispatchRuntime Az osztály használatával módosíthatja a szolgáltatás vagy az egyes végpontok alapértelmezett viselkedését, vagy olyan objektumokat szúrhat be, amelyek egyéni módosításokat hajtanak végre az alábbi szolgáltatási folyamatok egyikéhez vagy mindkettőhöz:

1. A bejövő üzenetek objektummá alakítása és az objektumok felszabadítása metódushívásként egy szolgáltatásobjektumon.

2. A válaszból kapott objektumok átalakítása egy szolgáltatásművelet meghívására kimenő üzenetekké.

A Windows kommunikációs alaprendszer (WCF) esetében a csatorna és a végpont diszpécserei az új csatornák elfogadásáért, az üzenetek fogadásáért, a metódusküldésért és a hívásért, valamint a válaszfeldolgozásért felelősek. Az objektum által ServiceHost közzétett végpontok mindegyike rendelkezik egy végpont-diszpécserrel és egy társított csatorna-diszpécserrel; emellett minden kétoldalas kommunikációban részt vevő ügyfél rendelkezik végpont-diszpécserrel és csatorna-diszpécserrel minden visszahívási végponthoz.

Ez DispatchRuntime lehetővé teszi a csatorna vagy végpont küldőjének elfogását és kiterjesztését egy adott szerződés összes üzenetéhez, még akkor is, ha egy üzenet nem ismerhető fel. Amikor olyan üzenet érkezik, amely nem egyezik a szerződésben deklarált üzenetekkel, a rendszer a tulajdonság által visszaadott műveletre küldi.UnhandledDispatchOperation Egy adott művelet összes üzenetének elfogásához vagy kiterjesztéséhez tekintse meg az osztályt DispatchOperation .

A diszpécser bővíthetőségének négy fő területét fedi le az DispatchRuntime osztály:

1. A küldési összetevők a tulajdonság által DispatchRuntime visszaadott társított csatorna-kézbesítő tulajdonságaival ChannelDispatcher szabják testre, hogy a csatornaelosztó hogyan fogadja el és zárja be a csatornákat. Ez a kategória tartalmazza a ChannelInitializers és InputSessionShutdownHandlers tulajdonságokat.

2. Az üzenetösszetevők minden feldolgozott üzenethez testre vannak szabva. Ez a kategória tartalmazza a MessageInspectors, OperationSelector, Operationsés a ErrorHandlers tulajdonságokat.

3. A példányösszetevők testre szabják a szolgáltatástípus példányainak létrehozását, élettartamát és ártalmatlanítását. A szolgáltatásobjektum élettartamával kapcsolatos további információkért tekintse meg a tulajdonságot InstanceContextMode . Ez a kategória tartalmazza a InstanceContextInitializers és InstanceProvider tulajdonságokat.

4. A biztonsággal kapcsolatos összetevők a következő tulajdonságokat használhatják:

   • SecurityAuditLogLocation azt jelzi, hogy hol vannak megírva a naplózási események.

   • ImpersonateCallerForAllOperations szabályozza, hogy a szolgáltatás a bejövő üzenet által megadott hitelesítő adatok felhasználásával megkísérli-e a megszemélyesítést.

   • MessageAuthenticationAuditLevel azt szabályozza, hogy a sikeres üzenethitelesítési eseményeket a rendszer a megadott SecurityAuditLogLocationeseménynaplóba írja-e.

   • PrincipalPermissionMode szabályozza, hogyan van beállítva a CurrentPrincipal tulajdonság.

   • ServiceAuthorizationAuditLevel az engedélyezési események naplózásának módját határozza meg.

   • SuppressAuditFailure megadja, hogy el kívánja-e tiltani a naplózási folyamat során előforduló nem kritikus kivételeket.

Az egyéni bővítményobjektumok általában egy DispatchRuntime tulajdonsághoz vannak rendelve, vagy egy szolgáltatás viselkedése (egy megvalósító IServiceBehaviorobjektum), szerződési viselkedés (megvalósító objektum IContractBehavior) vagy végponti viselkedés (implementált IEndpointBehaviorobjektum) által kerülnek be a gyűjteménybe. Ezután a rendszer hozzáadja a viselkedési objektumot a viselkedések megfelelő gyűjteményéhez programozott módon, vagy egy egyéni BehaviorExtensionElement objektum implementálásával, amely lehetővé teszi a viselkedés alkalmazáskonfigurációs fájllal való beszúrását.

Tulajdonságok

Név	Description
ChannelDispatcher	Lekéri a ChannelDispatcher küldési futásidejű objektumot.
MessageInspectors	Olyan objektumgyűjteményt IDispatchMessageInspector kap, amellyel egyéni üzenetfelügyelőt csatolhat a végponton keresztül érkező és kimenő üzenetekhez.