DispatchRuntime Clase

Definición

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Herencia

Object

DispatchRuntime

Comentarios

Utilice la clase DispatchRuntime para modificar el comportamiento predeterminado de un punto de conexión de servicio o individual o bien para insertar objetos que implementan las modificaciones personalizadas a uno o a los dos procesos del servicio siguientes:

1. La transformación de mensajes entrantes en los objetos y la suelta de esos objetos como invocaciones de método en un objeto de servicio.

2. La transformación de objetos recibidos de la respuesta a una invocación de operación de servicio en mensajes salientes.

En Windows Communication Foundation (WCF), los distribuidores de canales y puntos de conexión son los componentes de servicio responsables de aceptar nuevos canales, recibir mensajes, distribución de métodos e invocación y procesamiento de respuestas. Cada punto de conexión expuesto por un objeto ServiceHost tiene un distribuidor del punto de conexión y un distribuidor del canal asociado; además, cada cliente que participa en comunicación dúplex también tiene un distribuidor del punto de conexión y un distribuidor del canal para cada punto de conexión de devolución de llamada.

DispatchRuntime le permite interceptar y extender el canal o el distribuidor del extremo para todos los mensajes de un contrato determinado, incluso cuando no se reconoce un mensaje. Cuando llega un mensaje que no coincide con ningún mensaje declarado en el contrato, se envía a la operación devuelta por la propiedad UnhandledDispatchOperation. Para interceptar o extenderse por todos los mensajes de una operación determinada, vea la clase DispatchOperation.

Hay cuatro áreas principales de extensibilidad del distribuidor expuestas por la clase DispatchRuntime:

1. Los componentes de envío utilizan las propiedades de DispatchRuntime y las del distribuidor del canal asociado devueltas por la propiedad ChannelDispatcher para personalizar cómo el distribuidor del canal acepta y cierra los canales. Esta categoría incluye las propiedades ChannelInitializers y InputSessionShutdownHandlers.

2. Los componentes de mensaje se personalizan para cada mensaje procesado. Esta categoría incluye las propiedades MessageInspectors, OperationSelector, Operations y ErrorHandlers.

3. Los componentes de instancia personalizan la creación, duración y eliminación de instancias del tipo de servicio. Para obtener más información acerca de la duración de los objetos de servicio, vea la propiedad InstanceContextMode. Esta categoría incluye las propiedades InstanceContextInitializers y InstanceProvider.

4. Los componentes relacionados con seguridad pueden utilizar las propiedades siguientes:

   • SecurityAuditLogLocation indica donde se escriben los eventos de auditoría.

   • ImpersonateCallerForAllOperations controla si el servicio intenta suplantar mediante las credenciales proporcionadas por el mensaje entrante.

   • MessageAuthenticationAuditLevel controla si los eventos de autenticación de mensajes correctos se escriben en el registro de eventos especificado por SecurityAuditLogLocation.

   • PrincipalPermissionMode controla cómo se establece la propiedad CurrentPrincipal.

   • ServiceAuthorizationAuditLevel especifica cómo se realiza la auditoría de eventos de autorización.

   • SuppressAuditFailure especifica si suprimir excepciones no críticas que producen durante el proceso del registro.

Normalmente, un comportamiento de servicio (un objeto que implementa DispatchRuntime), un comportamiento de contrato (un objeto que implementa IServiceBehavior) o un comportamiento de extremo (un objeto que implementa IContractBehavior) pueden asignar objetos de extensión a una propiedad IEndpointBehavior o insertarlos en una colección. Entonces, el objeto de comportamiento de instalación se agrega a la colección adecuada de comportamientos mediante programación o implementando un objeto BehaviorExtensionElement personalizado para permitir insertar el comportamiento con un archivo de configuración de la aplicación.

Propiedades

Métodos

Se aplica a