DispatchRuntime Klass

Definition

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Arv

Object

DispatchRuntime

Kommentarer

DispatchRuntime Använd klassen antingen för att ändra standardbeteendet för en tjänst eller en enskild slutpunkt, eller för att infoga objekt som implementerar anpassade ändringar i en eller båda av följande tjänstprocesser:

1. Omvandlingen av inkommande meddelanden till objekt och frigöra dessa objekt som metodanrop på ett tjänstobjekt.

2. Omvandlingen av objekt som har mottagits från svaret på ett tjänsteanrop till utgående meddelanden.

I Windows Communication Foundation (WCF) är kanal- och slutpunktsutskickarna de tjänstkomponenter som ansvarar för att ta emot nya kanaler, ta emot meddelanden, metodsändning och anrop samt svarsbearbetning. Varje slutpunkt som exponeras av ett ServiceHost objekt har en slutpunktsutskickare och en associerad kanalsändare. Dessutom har varje klient som deltar i dubbelsidig kommunikation även en slutpunktsutskickare och kanalsändare för varje motringningsslutpunkt.

Möjliggör DispatchRuntime att du kan fånga upp och utöka kommunikationskanalen eller slutpunktshanteraren för alla meddelanden inom ett specifikt kontrakt, även om meddelandet inte känns igen. När ett meddelande tas emot som inte matchar några meddelanden som deklarerats i kontraktet skickas det till den åtgärd som returnerades av UnhandledDispatchOperation egenskapen. Information om hur du fångar upp eller utökar alla meddelanden för en viss åtgärd finns i klassen DispatchOperation.

Det finns fyra huvudområden för utökning av dispatcher som exponeras av klassen DispatchRuntime.

1. Dispatch-komponenter använder egenskaperna för och egenskaperna DispatchRuntime för den associerade kanalutskickaren som returneras av ChannelDispatcher egenskapen för att anpassa hur kanalutskickaren accepterar och stänger kanaler. Den här kategorin innehåller ChannelInitializers egenskaperna och InputSessionShutdownHandlers .

2. Meddelandekomponenter anpassas för varje bearbetat meddelande. Den här kategorin innehåller MessageInspectorsegenskaperna , OperationSelector, Operationsoch ErrorHandlers .

3. Instanskomponenter anpassar skapande, livslängd och bortskaffande av instanser av tjänsttypen. Mer information om livslängden för tjänstobjekt finns i egenskapen InstanceContextMode . Den här kategorin innehåller InstanceContextInitializers egenskaperna och InstanceProvider .

4. Säkerhetsrelaterade komponenter kan använda följande egenskaper:

   • SecurityAuditLogLocation anger var granskningshändelser skrivs.

   • ImpersonateCallerForAllOperations styr om tjänsten försöker personifiera med hjälp av de autentiseringsuppgifter som tillhandahålls av det inkommande meddelandet.

   • MessageAuthenticationAuditLevel styr om lyckade meddelandeautentiseringshändelser skrivs till händelseloggen som anges av SecurityAuditLogLocation.

   • PrincipalPermissionMode styr hur egenskapen CurrentPrincipal anges.

   • ServiceAuthorizationAuditLevel anger hur granskning av auktoriseringshändelser utförs.

   • SuppressAuditFailure anger om icke-kritiska undantag som inträffar under loggningsprocessen ska ignoreras.

Vanligtvis tilldelas anpassade tilläggsobjekt till en DispatchRuntime egenskap eller infogas i en samling av ett tjänstbeteende (ett objekt som implementerar IServiceBehavior), ett kontraktsbeteende (ett objekt som implementerar ) eller ett slutpunktsbeteende IContractBehavior(ett objekt som implementerar IEndpointBehavior). Sedan läggs installationsbeteendeobjektet till i lämplig samling beteenden antingen programmatiskt eller genom att implementera ett anpassat BehaviorExtensionElement objekt för att göra det möjligt att infoga beteendet med hjälp av en programkonfigurationsfil.