DispatchRuntime Classe

Definição

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Herança

Object

DispatchRuntime

Comentários

Use a DispatchRuntime classe para modificar o comportamento padrão de um serviço ou ponto de extremidade individual ou para inserir objetos que implementam modificações personalizadas em um ou ambos os seguintes processos de serviço:

1. A transformação de mensagens de entrada em objetos e liberação desses objetos como invocações de método em um objeto de serviço.

2. A transformação de objetos recebidos da resposta a uma invocação de operação de serviço em mensagens de saída.

No WCF (Windows Communication Foundation), os dispatchers de canal e ponto de extremidade são os componentes de serviço responsáveis por aceitar novos canais, receber mensagens, expedição e invocação de método e processamento de resposta. Cada ponto de extremidade exposto por um objeto tem um ServiceHost dispatcher de ponto de extremidade e um dispatcher de canal associado; além disso, cada cliente que participa da comunicação duplex também tem um dispatcher de ponto de extremidade e um dispatcher de canal para cada ponto de extremidade de retorno de chamada.

O DispatchRuntime permite que você intercepte e estenda o dispatcher de canal ou ponto de extremidade para todas as mensagens em um contrato específico, mesmo quando uma mensagem não é reconhecida. Quando chega uma mensagem que não corresponde a nenhuma mensagem declarada no contrato, ela é enviada para a operação que foi retornada pela UnhandledDispatchOperation propriedade. Para interceptar ou estender todas as mensagens para uma operação específica, consulte a DispatchOperation classe.

Há quatro áreas principais de extensibilidade do dispatcher expostas pela classe DispatchRuntime:

1. Os componentes de expedição usam as propriedades do dispatcher de DispatchRuntime canal associado retornados pela ChannelDispatcher propriedade para personalizar como o dispatcher de canal aceita e fecha canais. Esta categoria inclui as propriedades ChannelInitializers e InputSessionShutdownHandlers.

2. Os componentes de mensagem são personalizados para cada mensagem processada. Essa categoria inclui as propriedades MessageInspectors, OperationSelector, Operations e ErrorHandlers.

3. Os componentes de instância personalizam a criação, o ciclo de vida e o descarte das instâncias do tipo de serviço. Para obter mais informações sobre tempos de vida do objeto de serviço, confira a propriedade InstanceContextMode. Essa categoria inclui as propriedades InstanceContextInitializers e InstanceProvider.

4. Os componentes relacionados à segurança podem usar as seguintes propriedades:

   • SecurityAuditLogLocation indica onde os eventos de auditoria são gravados.

   • ImpersonateCallerForAllOperations controla se o serviço tentará representar usando as credenciais fornecidas pela mensagem de entrada.

   • MessageAuthenticationAuditLevel controla se eventos de autenticação de mensagem bem-sucedidos são gravados no log de eventos especificado por SecurityAuditLogLocation.

   • PrincipalPermissionMode controla como a CurrentPrincipal propriedade é definida.

   • ServiceAuthorizationAuditLevel especifica como a auditoria de eventos de autorização é executada.

   • SuppressAuditFailure especifica se deve suprimir exceções não críticas que ocorrem durante o processo de registro em log.

Normalmente, objetos de extensão personalizados são atribuídos a uma DispatchRuntime propriedade ou inseridos em uma coleção por um comportamento de serviço (um objeto que implementa IServiceBehavior), um comportamento de contrato (um objeto que implementa IContractBehavior) ou um comportamento de ponto de extremidade (um objeto que implementa IEndpointBehavior). Em seguida, o objeto de comportamento de instalação é adicionado à coleção apropriada de comportamentos programaticamente ou implementando um objeto personalizado BehaviorExtensionElement para permitir que o comportamento seja inserido usando um arquivo de configuração de aplicativo.