Concepteur d'activités ReceiveReceive Activity Designer

Le réception ActivityDesigner est utilisé pour créer et configurer un Receive activité.The Receive activity designer is used to create and configure a Receive activity. Une activité Receive est une activité qui reçoit un message qui peut être un type intégré, tel que Message, Stream ou XElement, ou un contrat de données défini par l'application, un contrat de message ou une classe XML sérialisable.A Receive activity is an activity that receives a message that can be either a built-in type such as Message, Stream or XElement, or an application-defined data contract, message contract, or XML class that can be serialized.

Activité ReceiveThe Receive Activity

L'activité Receive peut recevoir un élément unique ou plusieurs éléments selon le type de contenu de réception utilisé.The Receive activity can receive a single item or multiple items depending on the type of receive content used. Une activité SendReply peut être liée à une activité Receive qui reçoit un message dans le cadre d'un modèle d'échange de messages de demande/réponse sur le service.A SendReply activity can be bound to a Receive activity that receives a message as part of a request/response message exchange pattern on the service.

Utilisation du concepteur d'activités ReceiveUsing the Receive Activity Designer

Le réception Concepteur d’activités peut être trouvé dans le messagerie catégorie de la boîte à outils, qui est accessible en cliquant sur les boîte à outilsonglet sur le Concepteur de flux de travail (ou bien, sélectionnez barre d’outils à partir de la vue menu ou CTRL + ALT + X.)The Receive activity designer can be found in the Messaging category of the Toolbox, which is accessed by clicking the Toolbox tab on the Workflow Designer (Alternatively, select Toolbar from the View menu or CTRL+ALT+X.)

Le réception Concepteur d’activités peut être déplacé de la boîte à outils et déposés dans l’aire du Concepteur de flux de travail où les activités sont généralement placées.The Receive activity designer can be dragged from the Toolbox and dropped on to the Workflow Designer surface wherever activities are usually placed. Cette opération crée une activité Receive avec une propriété DisplayName affectée de la valeur par défaut Receive.This creates a Receive activity with a default DisplayName of Receive. Le DisplayName peuvent être modifiées dans l’en-tête de la réception Concepteur d’activités ou dans le DisplayName zone de la grille des propriétés.The DisplayName can be edited in the header of the Receive activity designer or in the DisplayName box of the property grid.

Pour créer un SendReply activité et le lier au Receive activité, avec le bouton droit le réception cliquez sur Générateur d’activité le Create SendReply élément dans le menu contextuel et le SendReplyToReceive concepteur apparaît sous le réception concepteur.To create a SendReply activity and bind it to the selected Receive activity, right-click the Receive activity designer, click the Create SendReply item in the context menu and the SendReplyToReceive designer appears below the Receive designer. L'activité SendReply est une activité qui envoie le message de réponse dans le cadre d'un modèle d'échange de messages de demande/réponse sur le service.The SendReply activity is an activity that sends the reply message as part of a request/response message exchange pattern on the service. Il peut être configuré avec le SendReplyToReceive concepteur.It can be configured with the SendReplyToReceive designer.

Vous pouvez également le ReceiveAndSendReply Concepteur de modèles dans le messagerie catégorie de la boîte à outils peut être utilisé pour créer une paire de préconfiguréReceiveet SendReply activité.Alternatively, the ReceiveAndSendReply template designer in the Messaging category of the Toolbox can be used to create a pair of pre-configured Receive and SendReply activity. Pour plus d’informations sur l’utilisation de la ReceiveAndSendReply et SendReplyToReceive modèle, consultez la ReceiveAndSendReply rubrique.For more information about the use of the ReceiveAndSendReply and SendReplyToReceive template, see the ReceiveAndSendReply topic.

Propriétés de l'activité ReceiveThe Receive Activity Properties

Le tableau suivant présente les propriétés de Receive et décrit comment elles sont utilisées dans le concepteur.The following table shows the Receive properties and describes how they are used in the designer. Ces propriétés peuvent être modifiées dans la grille des propriétés ou sur l’aire du Concepteur de flux de travail.These properties can be edited in properties grid or on the Workflow Designer surface. Seule la propriété OperationName est obligatoire.The only required property is the OperationName property.

Nom de la propriétéProperty Name ObligatoireRequired UtilisationUsage
DisplayName FalseFalse Spécifie le nom convivial de l'activité Receive.Specifies the friendly name of the Receive activity. La valeur par défaut est Receive.The default value is Receive.

Bien que l'utilisation d'une valeur autre que celle par défaut pour le nom convivial de la propriété DisplayName ne soit pas strictement obligatoire, il est recommandé d'utiliser une telle valeur.Although the use of a non-default value for the friendly DisplayName is not strictly required, it is a best practice to use such a value.
OperationName TrueTrue Spécifie le nom de l'opération de service implémenté par cette activité Receive.Specifies the name of the service operation implemented by this Receive activity. Cette propriété est utilisée pour construire la valeur par défaut pour le Action propriété si le Action propriété n’est pas définie explicitement.This property is used to construct the default value for the Action property if the Action property is not explicitly set.
ServiceContractName FalseFalse Spécifie le nom du contrat de service.Specifies the name of the service contract. Cette propriété permet de regrouper des opérations de service dans des contrats de service individuels.This property is used to group service operations into individual service contracts. Toutes les activités Receive qui ont le même ServiceContractName sont regroupées dans le même contrat de service (type de port WSDL).All Receive activities that have the same ServiceContractName are grouped into the same service contract (WSDL Port Type). La valeur par défaut est le nom CLR complet de l'activité de niveau supérieur (racine).The default value is the fully-qualified CLR name of the top level (root) activity.
Content FalseFalse Spécifie le contenu du message ou du paramètre à recevoir.Specifies the message or parameter content to receive. Il peut s'agir d'une activité ReceiveMessageContent ou d'une activité ReceiveParametersContent.It can be either a ReceiveMessageContent activity or a ReceiveParametersContent activity. Modifier cette propriété en cliquant sur le bouton de sélection en regard de la contenu champ dans la grille des propriétés ou en cliquant sur le définir... en regard du contenu l’étiquette sur le réception aire du Concepteur d’activité.Edit this property by clicking the ellipse button beside the Content field in property grid or clicking the Define... button beside the Content label on the Receive activity designer surface. Les deux affichent la définition du contenu boîte de dialogue.Both display the Content Definition dialog. Pour plus d’informations sur l’utilisation de cette zone, consultez la boîte de dialogue de définition de contenu rubrique.For more information about how to use this box, see the Content Definition Dialog Box topic.
CorrelatesOn FalseFalse Spécifie les corrélations entre des activités Receive dans des opérations de service d'un workflow avec un objet MessageQuerySet.Specifies the correlations between Receive activities in service operations of a workflow with a MessageQuerySet object. Cliquez sur le bouton de sélection en regard du CorrelatesOn propriété dans la grille des propriétés pour ouvrir la définition CorrelatesOn boîte de dialogue.Click the ellipsis button next to the CorrelatesOn property in the properties grid to open the CorrelatesOn Definition dialog box. Pour plus d’informations sur l’utilisation de cette boîte de dialogue, consultez la boîte de dialogue de définition de contenu rubrique.For more information about the use of this dialog box, see the Content Definition Dialog Box topic.
CorrelatesWith FalseFalse Spécifie l'objet CorrelationHandle utilisé pour router le message vers l'instance de workflow appropriée.Specifies the CorrelationHandle used to route the message to the appropriate workflow instance.

Cliquez sur le bouton de sélection en regard du CorrelatesWith propriété dans la grille des propriétés pour ouvrir la l’éditeur d’Expression boîte de dialogue.Click the ellipsis button next to the CorrelatesWith property in the properties grid to open the Expression Editor dialog box. Pour plus d’informations sur l’utilisation de cette boîte de dialogue, consultez la Comment : utiliser l’éditeur d’Expression rubrique.For more information about the use of this dialog box, see the How to: Use the Expression Editor topic.
CorrelationInitializers FalseFalse Spécifie la collection d'objets CorrelationInitializer initialisant plusieurs objets CorrelationHandle qui configurent cette activité Receive dans le workflow.Specifies the collection of CorrelationInitializer objects that initialize multiple CorrelationHandle objects that configure this Receive activity within the workflow. Cliquez sur le bouton de sélection en regard du CorrelationInitializers propriété dans la grille des propriétés pour ouvrir la ajouter des initialiseurs de corrélation boîte de dialogue.Click the ellipsis button next to the CorrelationInitializers property in the properties grid to open the Add Correlation Initializers dialog box. Pour plus d’informations sur l’utilisation de cette zone, consultez la boîte de dialogue Ajouter CorrelationInitializers rubrique.For more information about using this box, see the Add CorrelationInitializers Dialog Box topic.
CanCreateInstance FalseFalse Spécifie une valeur qui détermine si une nouvelle instance de workflow est créée pour traiter le message si le message n'est pas corrélé à une instance de workflow existante.Specifies a value that determines whether a new workflow instance is created to process the message if the message does not correlate to an existing workflow instance. Si la valeur est définie sur true, une nouvelle instance de flux de travail est créée pour traiter le message lorsque le message n’est pas mis en corrélation avec une instance de flux de travail existant.If the value is set to true, a new workflow instance is created to process the message when the message is not correlated with an existing workflow instance.
KnownTypes FalseFalse Spécifie une collection de types connus pour l'opération de service implémentée par cette activité Receive.Specifies a collection of known types for the service operation implemented by this Receive activity. Cette propriété doit être utilisée conjointement à la propriété SerializerOption affectée de la valeur DataContractSerializer.This property should be used in conjunction with the SerializerOption property set to DataContractSerializer. Elle est ignorée si XmlSerializer est utilisé.It is ignored if XmlSerializer is used.

Cliquez sur le bouton de sélection en regard de la KnownTypes champ dans la grille des propriétés pour afficher la éditeur de collections Type boîte de dialogue avec laquelle vous pouvez ajouter des types pertinents.Click the ellipse button beside the KnownTypes field in property grid to display the Type Collection Editor dialog box with which you can add relevant types. Pour plus d’informations sur l’utilisation de cette zone, consultez la boîte de dialogue Éditeur de Collection de Type rubrique.For more information about using this box, see the Type Collection Editor Dialog Box topic.
ProtectionLevel FalseFalse Spécifie l'objet ProtectionLevel du message.Specifies the ProtectionLevel for the message.

1. ProtectionLevel signifie que l’authentification uniquement.1. ProtectionLevel means authentication only.
2. ProtectionLevel signifie la signature des données pour garantir l’intégrité des données transmises.2. ProtectionLevel means sign data to help ensure the integrity of transmitted data.
3. ProtectionLevel signifie chiffrer et signer des données pour garantir la confidentialité et l’intégrité des données transmises.3. ProtectionLevel means encrypt and sign data to help ensure the confidentiality and integrity of transmitted data.
SerializerOption FalseFalse Spécifie le type de sérialiseur à utiliser pour l'opération de service implémentée par l'activité Receive.Specifies the type of serializer to use for the service operation implemented by the Receive activity. La valeur par défaut est DataContractSerializer, qui sérialise et désérialise une instance d'un type dans un flux ou document XML utilisant un contrat de données fourni.The default value is DataContractSerializer, which serializes and deserializes an instance of a type into an XML stream or document that uses a supplied data contract. XmlSerializer peut également être utilisé s'il est nécessaire de mieux contrôler les données XML.The XmlSerializer can also be used if more control is required over the XML.
Action FalseFalse Spécifie l'en-tête Action header du message.Specifies the action header of the message. Si elle n’est pas définie explicitement, sa valeur par défaut : https://tempuri.org/{service espace de noms de contrat} / {nom de contrat de service} / {nom de l’opération}.If it is not explicitly set, its value defaults to: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}.

Voir aussiSee also