DispatchRuntime Класс

Определение

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Наследование

Object

DispatchRuntime

Комментарии

DispatchRuntime Используйте класс для изменения поведения службы или отдельной конечной точки по умолчанию или вставки объектов, реализующих пользовательские изменения в одном или обоих из следующих процессов службы:

1. Преобразование входящих сообщений в объекты и освобождение этих объектов в качестве вызовов метода для объекта службы.

2. Преобразование объектов, полученных от ответа на вызов операции службы в исходящие сообщения.

В Windows Communication Foundation (WCF) диспетчеры каналов и конечных точек являются компонентами служб, ответственными за прием новых каналов, получение сообщений, отправку методов и вызов и обработку ответов. Каждая конечная точка, предоставленная ServiceHost объектом, имеет один диспетчер конечных точек и связанный диспетчер каналов. Кроме того, каждый клиент, участвующий в дуплексном взаимодействии, также имеет диспетчер конечных точек и диспетчер каналов для каждой конечной точки обратного вызова.

Этот компонент DispatchRuntime позволяет вам перехватывать и расширять диспетчер каналов или конечных точек для всех сообщений в определенном контракте, даже если сообщение не распознается. Когда сообщение поступает, которое не соответствует ни одному сообщению, объявленному в контракте, оно отправляется в операцию, возвращенную свойством UnhandledDispatchOperation . Чтобы перехватывать или расширять все сообщения для определенной операции, смотрите класс DispatchOperation.

Существует четыре основных области расширяемости диспетчера, предоставляемые классом DispatchRuntime :

1. Компоненты диспетчера используют свойства DispatchRuntime диспетчера и диспетчера связанного канала, возвращаемого ChannelDispatcher свойством, для настройки приема и закрытия каналов диспетчера каналов. Эта категория включает в себя ChannelInitializers и InputSessionShutdownHandlers свойства.

2. Компоненты сообщения настраиваются для каждого обработанного сообщения. Эта категория включает MessageInspectors, OperationSelector, Operations и ErrorHandlers свойства.

3. Компоненты экземпляров настраивают создание, время существования и удаление экземпляров типа службы. Дополнительные сведения о времени существования объекта службы см. в свойстве InstanceContextMode . Эта категория включает InstanceContextInitializers свойства и InstanceProvider свойства.

4. Компоненты, связанные с безопасностью, могут использовать следующие свойства:

   • SecurityAuditLogLocation указывает, где записываются события аудита.

   • ImpersonateCallerForAllOperations определяет, пытается ли служба использовать предоставленные входящим сообщением учетные данные для имитации пользователя.

   • MessageAuthenticationAuditLevel определяет, записываются ли события проверки подлинности сообщения в журнал событий, указанный в журнале SecurityAuditLogLocationсобытий.

   • PrincipalPermissionMode определяет, как задано CurrentPrincipal свойство.

   • ServiceAuthorizationAuditLevel указывает, как выполняется аудит событий авторизации.

   • SuppressAuditFailure указывает, следует ли подавлять некритичные исключения, возникающие во время процесса ведения журнала.

Обычно пользовательские объекты расширения назначаются DispatchRuntime свойству или вставляются в коллекцию поведением службы (объектом, IServiceBehaviorреализующим), поведением контракта (объектом, реализующим IContractBehaviorобъект), или поведением конечной точки (объектом, реализующим IEndpointBehavior). Затем объект установки поведения добавляется в соответствующую коллекцию объектов поведения программным способом или путем реализации пользовательского объекта BehaviorExtensionElement, чтобы обеспечить возможность вставки поведения с помощью файла конфигурации приложения.