DispatchRuntime Classe

Definição

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Herança

Object

DispatchRuntime

Observações

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

1. A transformação de mensagens de entrada em objetos e a 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 Windows Communication Foundation (WCF), os despachantes do canal e dos endpoints são os componentes de serviço responsáveis por aceitar novos canais, receber mensagens, despachar e invocar métodos, e processar respostas. Cada ponto final exposto por um ServiceHost objeto tem um despachante de endpoint e um despachante de canal associado; além disso, cada cliente que participa na comunicação duplex também tem um despachante de endpoint e um despachante de canal para cada endpoint de callback.

O DispatchRuntime permite-lhe interceptar e estender o canal ou o despachante de endpoints para todas as mensagens num contrato específico, mesmo quando uma mensagem não é reconhecida. Quando chega uma mensagem que não corresponde a nenhuma das mensagens declaradas no contrato, ela é enviada para a operação que foi devolvida pela UnhandledDispatchOperation propriedade. Para intercetar ou estender todas as mensagens de uma operação específica, consulte a DispatchOperation classe.

Existem quatro áreas principais de extensibilidade do despachante expostas pela DispatchRuntime classe:

1. Os componentes de despacho utilizam as propriedades do DispatchRuntime e das do despachante de canal associado devolvidas pela ChannelDispatcher propriedade para personalizar como o despachante de canal aceita e fecha os canais. Esta categoria inclui as ChannelInitializers propriedades e InputSessionShutdownHandlers .

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

3. Os componentes de instância personalizam a criação, o tempo de vida e o descarte de instâncias do tipo de serviço. Para obter mais informações sobre o ciclo de vida dos objetos de serviço, consulte a propriedade InstanceContextMode. Esta categoria inclui as InstanceContextInitializers e as InstanceProvider propriedades.

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 tenta impersonar usando as credenciais fornecidas pela mensagem de entrada.

   • MessageAuthenticationAuditLevel Controla se os eventos de autenticação de mensagem bem-sucedida são gravados no log de eventos especificado pelo SecurityAuditLogLocation.

   • PrincipalPermissionMode Controla como a CurrentPrincipal propriedade é definida.

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

   • SuppressAuditFailure Especifica se as exceções não críticas que ocorrem durante o processo de registro em log devem ser suprimidas.

Normalmente, objetos de extensão personalizados são atribuídos a uma DispatchRuntime propriedade ou inseridos numa 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 endpoint (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 do aplicativo.