Diseñador de actividades Receive
El diseñador de actividades Receive se utiliza para crear y configurar una actividad Receive. Una actividad Receive es una actividad que recibe un mensaje que puede ser de tipo integrado como Message, Stream o XElement o bien, un contrato de datos definido por la aplicación, contrato de mensaje o clase XML que se pueden serializar.
Actividad Receive
La actividad Receive puede recibir un elemento único o varios elementos, en función del tipo de contenido de Receive que se utilice. Una actividad SendReply se puede enlazar a una actividad Receive que reciba un mensaje como parte de un patrón de intercambio de mensajes solicitud/respuesta en el servicio.
Utilizar el diseñador de actividades Receive
Acceda al diseñador de actividades Receive en la categoría Mensajería del Cuadro de herramientas. El diseñador de actividades Receive se puede arrastrar desde el Cuadro de herramientas y colocar en la superficie del Diseñador de flujo de trabajo, dondequiera que se coloquen normalmente las actividades. Esto crea una actividad Receive con una propiedad DisplayName predeterminada de Receive. El valor DisplayName se puede editar en el encabezado del diseñador de actividades Receive o en el cuadro DisplayName de la cuadrícula de propiedades.
Para crear una actividad SendReply y enlazarla a la actividad Receive seleccionada, haga clic con el botón secundario en el diseñador de actividades Receive, haga clic en el elemento Crear SendReply del menú contextual y aparecerá el diseñador SendReplyToReceive en el diseñador Receive. La actividad SendReply es una actividad que envía el mensaje de respuesta como parte de un patrón de intercambio de mensajes solicitud/respuesta en el servicio. Se puede configurar con el diseñador SendReplyToReceive.
Como alternativa, el diseñador de la plantilla de ReceiveAndSendReply en la categoría Mensajería del Cuadro de herramientas se puede usar para crear un par de actividades Receive y SendReply configuradas previamente. Para más información sobre el uso de la plantilla de ReceiveAndSendReply y SendReplyToReceive, consulte el tema ReceiveAndSendReply.
Propiedades de la actividad Receive
En la tabla siguiente se muestran las propiedades Receive y se describe cómo se utilizan en el diseñador. Estas propiedades se pueden editar en la cuadrícula de propiedades o en la superficie del Diseñador de flujo de trabajo. La única propiedad obligatoria es OperationName.
| Nombre de propiedad | Obligatorio | Uso |
|---|---|---|
| DisplayName | False | Especifica el nombre descriptivo de la actividad Receive. El valor predeterminado es Receive. Aunque no es obligatorio utilizar un valor no predeterminado para la propiedad DisplayName descriptiva, se recomienza utilizar uno. |
| OperationName | True | Especifica el nombre de la operación de servicio que implementa esta actividad Receive. Esta propiedad se utiliza a fin de construir el valor predeterminado para la propiedad Action si esta propiedad no se ha establecido explícitamente. |
| ServiceContractName | Falso | Especifica el nombre del contrato de servicios. Esta propiedad se utiliza para agrupar las operaciones de servicio en los contratos de servicios individuales. Todas las actividades Receive que tienen la misma propiedad ServiceContractName están agrupadas en el mismo contrato de servicios (tipo de puerto WSDL asociado). El valor predeterminado es el nombre de CLR completo correspondiente a la actividad de nivel superior (raíz). |
| Content | Falso | Especifica el mensaje o contenido del parámetro que se va a recibir. Puede ser una actividad ReceiveMessageContent o una actividad ReceiveParametersContent. Edite esta propiedad; para ello, seleccione el botón de puntos suspensivos junto al campo Contenido en la cuadrícula de propiedades o haga clic en el botón Definir... situado junto a la etiqueta Contenido en la superficie del diseñador de actividades Receive. Ambos muestran el cuadro de diálogo Definición de contenido. Para obtener más información sobre cómo usar este cuadro, vea el tema Cuadro de diálogo Definición de contenido. |
| CorrelatesOn | Falso | Especifica las correlaciones entre las actividades Receive en operaciones de servicio de un flujo de trabajo con un objeto MessageQuerySet. Haga clic en el botón de puntos suspensivos junto a la propiedad CorrelatesOn de la cuadrícula de propiedades para abrir el cuadro de diálogo Definición de CorrelatesOn. Para más información sobre cómo el uso de este cuadro de diálogo, consulte el tema Cuadro de diálogo Definición de contenido. |
| CorrelatesWith | False | Especifica la clase CorrelationHandle que se utiliza para enrutar el mensaje hacia la instancia de flujo de trabajo adecuada. Haga clic en el botón de puntos suspensivos situado junto a la propiedad CorrelatesWith en la cuadrícula de propiedades para abrir el cuadro de diálogo Editor de expresiones. Para más información sobre el uso de este cuadro de diálogo, consulte el tema Procedimientos para usar el Editor de expresiones. |
| CorrelationInitializers | Falso | Especifica la colección de objetos CorrelationInitializer que inicializan varios objetos CorrelationHandle que configuran esta actividad Receive en el flujo de trabajo. Haga clic en el botón de puntos suspensivos junto a la propiedad CorrelationInitializers en la cuadrícula de propiedades para abrir el cuadro de diálogo Agregar inicializadores de correlación. Para más información sobre cómo usar este cuadro, consulte el tema Agregar cuadro de diálogo CorrelationInitializers. |
| CanCreateInstance | Falso | Especifica un valor que determina si una nueva instancia de flujo de trabajo se crea para procesar el mensaje en caso de que el mensaje no se correlacione con una instancia de flujo de trabajo existente. Si el valor está establecido en true, se crea una nueva instancia de flujo de trabajo para procesar el mensaje cuando el mensaje no se correlacione con una instancia de flujo de trabajo existente. |
| KnownTypes | False | Especifica una colección de tipos conocidos para la operación de servicio implementada por esta actividad Receive. Esta propiedad se puede utilizar junto con el conjunto de propiedades SerializerOption para DataContractSerializer. Se ignorará si se usa XmlSerializer. Seleccione el botón de puntos suspensivos situado junto al campo KnownTypes en la cuadrícula de propiedades para mostrar el cuadro de diálogo Editor de colección de tipos con el que podrá agregar los tipos pertinentes. Para más información sobre cómo usar este cuadro, consulte el tema Cuadro de diálogo Editor de colección de tipos. |
| ProtectionLevel | False | Especifica la enumeración ProtectionLevel para el mensaje. 1. ProtectionLevel solo hace referencia a la autenticación. 2. ProtectionLevel hace referencia a los datos con firma digital con el fin de garantizar la integridad de los datos transmitidos. 3. ProtectionLevel hace referencia a los datos cifrados y con firma digital con el fin de ayudar a garantizar la confidencialidad y la integridad de los datos transmitidos. |
| SerializerOption | False | Especifica el tipo de serializador que se va a utilizar para la operación de servicio que implementa la actividad Receive. El valor predeterminado es DataContractSerializer, que serializa y deserializa una instancia de un tipo en una secuencia o en un documento XML que utilice un contrato de datos que se haya proporcionado. Se puede utilizar también XmlSerializer si se requiere un mayor control de XML. |
| Action | False | Especifica el encabezado de acción del mensaje. Si no se establece explícitamente, su valor predeterminado será: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}. |