DispatchRuntime Clase

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v8.0.0

Source:

DispatchRuntime.cs

Expone propiedades que se pueden utilizar para modificar el comportamiento del servicio predeterminado y adjunta objetos personalizados que pueden modificar el modo en que los mensajes entrantes se transforman en objetos y envían a las operaciones. Esta clase no puede heredarse.

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

ChannelDispatcher	Obtiene el ChannelDispatcher para este objeto de envío en tiempo de ejecución.
MessageInspectors	Obtiene una colección de los objetos IDispatchMessageInspector que se pueden utilizar para asociar a un inspector del mensaje personalizado para todos los mensajes que entran y salen por el punto de conexión.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)