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 modelo de intercambio de mensajes solicitud/respuesta en el servicio.

Utilizar el diseñador de actividades Receive

El diseñador de actividades Receive se puede encontrar en la categoría Mensajería del Cuadro de herramientas, al que se tiene acceso al hacer clic en la pestaña Cuadro de herramientas de Diseñador de flujo de trabajo. (De forma alternativa, seleccione Barra de herramientas en el menú Ver o CTRL+ALT+X).

El diseñador de actividades Receive se puede arrastrar desde el Cuadro de herramientas y colocar en la superficie de Diseñador de flujo de trabajo, donde 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 modelo de intercambio de mensajes solicitud/respuesta en el servicio. Se puede configurar con el diseñador SendReplyToReceive.

De forma alternativa, el diseñador de plantillas ReceiveAndSendReply en la categoría Mensajería del Cuadro de herramientas se puede utilizar para crear una pareja con las actividades SendReply y Receive configuradas previamente. Para obtener más información sobre sobre cómo se usa la plantilla ReceiveAndSendReply y SendReplyToReceive, vea el tema Diseñador de plantillas 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 de Diseñador de flujo de trabajo. La única propiedad obligatoria es OperationName.

Nombre de la 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 para construir el valor predeterminado para la propiedad Action si la propiedad Action no se ha establecido explícitamente.
ServiceContractName	False	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	False	Especifica el mensaje o contenido del parámetro que se va a recibir. Puede ser una actividad ReceiveMessageContent o una actividad ReceiveParametersContent. Modifique esta propiedad, para ello haga clic en el botón de puntos suspensivos junto al campo Contenido en la cuadrícula de propiedades o haga clic en el botón Definir... 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 sobre cómo utilizar este cuadro, vea el tema Definición de contenido (cuadro de diálogo).
CorrelatesOn	False	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 en la cuadrícula de propiedades para abrir el cuadro de diálogo Definición de CorrelatesOn. Para obtener más información sobre sobre el uso de este cuadro de diálogo, consulte el tema Definición de contenido (cuadro de diálogo).
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 junto a la propiedad CorrelatesWith en la cuadrícula de propiedades para abrir el cuadro de diálogo Editor de expresiones. Para obtener más información sobre sobre el uso de este cuadro de diálogo, consulte el tema Cómo: Utilizar el Editor de expresiones.
CorrelationInitializers	False	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 obtener más información sobre sobre cómo utilizar este cuadro, vea el tema Agregar CorrelationInitializers (cuadro de diálogo).
CanCreateInstance	False	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. Haga clic en el botón de los puntos suspensivos 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 obtener más información sobre sobre cómo utilizar este cuadro, consulte el tema Editor de colección de tipos (cuadro de diálogo).
ProtectionLevel	False	Especifica la enumeración ProtectionLevel para el mensaje. None solo hace referencia a la autenticación. Sign hace referencia a los datos con firma digital con el fin de garantizar la integridad de los datos transmitidos. EncryptAndSign 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, se utiliza el valor predeterminado que es: `https://tempuri.org/{espacio de nombres del contrato de servicios}/{nombre del contrato de servicios}/{nombre de la operación}`.

Vea también

Conceptos

Diseñador de actividades InitializeCorrelation
Diseñador de actividades CorrelationScope
Diseñador de plantillas ReceiveAndSendReply
Diseñador de actividad Sent
Diseñador de plantillas SendAndReceiveReply
Diseñador de actividades TransactedReceiveScope

Last updated on 2011-02-27