Recebe o designer de atividades
O designer de atividade Receive é usado para criar e configurar uma atividade Receive. Uma atividade de Receive é uma atividade que receberá uma mensagem que pode ser um tipo interno como Message, Stream ou XElement, ou um contrato definido de dados, o contrato de mensagem, ou a classe XML que pode ser serializada.
A atividade de receptor
A atividade de Receive pode receber um item único ou vários itens dependendo do tipo de recebem o conteúdo usado. Uma atividade de SendReply pode ser associada a uma atividade de Receive que receberá uma mensagem como parte de um padrão de troca de solicitação/resposta de mensagem no serviço.
Usando o designer de atividade de receptor
Acesse o designer da atividade Receive na categoria Messaging da Caixa de Ferramentas. O designer da atividade Receive pode ser arrastado da Caixa de Ferramentas e solto sobre a superfície do Designer de Fluxo de Trabalho onde as atividades costumam ser colocadas. Isso cria uma atividade de Receive com DisplayName padrão Receive. O DisplayName pode ser editado no cabeçalho do designer de atividade Receive ou na caixa de DisplayName da grade de propriedades.
Para criar uma atividade SendReply e associá-la à atividade Receive selecionada, clique com o botão direito do mouse no designer de atividade Receive, clique no item Criar SendReply no menu de contexto e o designer de SendReplyToReceive aparecerá abaixo do designer de Receive. A atividade de SendReply é uma atividade que envia a mensagem de resposta como parte de um padrão de troca de solicitação/resposta de mensagem no serviço. Pode ser configurado com o designer de SendReplyToReceive.
Como alternativa, o designer de modelo ReceiveAndSendReply na categoria Messaging da Caixa de ferramentas pode ser usado para criar um par de atividades Receive e SendReply pré-configuradas. Para obter mais informações sobre o uso do modelo ReceiveAndSendReply e SendReplyToReceive, confira o tópico ReceiveAndSendReply.
As propriedades de atividade de receptor
A tabela a seguir mostra as propriedades de Receive e descreve como elas são usadas no designer. Essas propriedades podem ser editadas na grade de propriedades ou na superfície do Designer de Fluxo de Trabalho. A única propriedade necessário é a propriedade de OperationName .
| Nome da propriedade | Obrigatório | Uso |
|---|---|---|
| DisplayName | Falso | Especifica o nome amigável de atividade de Receive . O valor padrão é receber. Embora o uso de um valor não padrão para DisplayName amigável não é necessário restrita, é uma prática recomendada usar um valor. |
| OperationName | True | Especifica o nome da operação de serviço implementada por esta atividade de Receive . Essa propriedade será usada para construir o valor padrão da propriedade Ação se a propriedade Ação não for definida explicitamente. |
| ServiceContractName | Falso | Especifica o nome do contrato de serviço. Essa propriedade é usada para agrupar operações de serviço em contratos de serviço individuais. Todas as atividades de Receive que têm mesmo ServiceContractName são agrupadas no mesmo contrato de serviço (tipo de porta de WSDL.) O valor padrão é o nome totalmente qualificado de CLR de atividade de nível superior (raiz). |
| Content | Falso | Especifica o conteúdo de mensagem ou de parâmetro para receber. Pode ser uma atividade de ReceiveMessageContent ou uma atividade de ReceiveParametersContent . Edite essa propriedade selecionando o botão de reticências ao lado do campo Conteúdo na grade de propriedades ou clicando no botão Definir… ao lado do rótulo Conteúdo na superfície do designer da atividade Receber. Ambos exibem a caixa de diálogo Definição de Conteúdo. Para obter mais informações sobre como usar essa caixa, consulte o tópico Caixa de diálogo Definição de Conteúdo. |
| CorrelatesOn | Falso | Especifica se correlaciona entre atividades de Receive em operações de serviço de um fluxo de trabalho com um objeto de MessageQuerySet . Clique no botão de reticências próximo à propriedade CorrelatesOn na grade de propriedades para abrir a caixa de diálogo Definição de CorrelatesOn. Para obter mais informações sobre o uso dessa caixa de diálogo, confira o tópico Caixa de diálogo Definição de Conteúdo. |
| CorrelatesWith | Falso | Especifica CorrelationHandle usado para rotear a mensagem à instância apropriado de fluxo de trabalho. Clique no botão de reticências ao lado da propriedade CorrelatesWith na grade de propriedades para abrir a caixa de diálogo Editor de Expressões. Para obter mais informações sobre o uso dessa caixa de diálogo, confira o tópico Como usar o Editor de Expressões. |
| CorrelationInitializers | Falso | Especifica a coleção de objetos de CorrelationInitializer que inicializam vários objetos de CorrelationHandle que configuram esta atividade de Receive dentro de fluxo de trabalho. Clique no botão de reticências ao lado da propriedade CorrelationInitializers na grade de propriedades para abrir a caixa de diálogo Adicionar Inicializadores de Correlação. Para obter mais informações sobre como usar essa caixa, consulte o tópico Caixa de diálogo Adicionar Inicializadores de Correlação. |
| CanCreateInstance | Falso | Especifica um valor que determina se uma nova instância de fluxo de trabalho é criada para processar a mensagem se a mensagem não correlaciona a uma instância existente de fluxo de trabalho. Se o valor é definido como true, uma nova instância de fluxo de trabalho é criada para processar a mensagem quando a mensagem não é correlacionada com uma instância existente de fluxo de trabalho. |
| KnownTypes | Falso | Especifica uma coleção de tipos conhecidos para a operação de serviço implementada por esta atividade de Receive . Esta propriedade deve ser usada em conjunto com a propriedade de SerializerOption definida como DataContractSerializer. É ignorada se XmlSerializer é usado. Clique no botão de reticências ao lado do campo KnownTypes na grade de propriedades para exibir a caixa de diálogo Editor de Coleção de Tipo, com o qual você pode adicionar tipos relevantes. Para obter mais informações sobre como usar essa caixa de diálogo, confira o tópico Caixa de diálogo Editor de Coleção de Tipos. |
| ProtectionLevel | Falso | Especifica ProtectionLevel para a mensagem. 1. ProtectionLevel significa somente autenticação. 2. ProtectionLevel significa assinar dados para ajudar a garantir a integridade dos dados transmitidos. 3. ProtectionLevel significa criptografar e assinar dados para ajudar a garantir a confidencialidade e a integridade dos dados transmitidos. |
| SerializerOption | Falso | Especifica o tipo de serializador para usar a operação de serviço implementada pela atividade de Receive . O valor padrão é DataContractSerializer, que serializa e desserializa uma instância de um tipo em um fluxo XML ou em um documento que usa um contrato fornecido de dados. XmlSerializer também pode ser usado se mais controle sobre é necessário XML. |
| Action | Falso | Especifica o cabeçalho da ação de mensagem. Se não é explicitamente definida, o valor usado por padrão será: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}. |