Návrhář aktivity Receive
Návrhář aktivity Receive slouží k vytvoření a konfiguraci Receive aktivity. Receive Aktivita je aktivita, která přijímá zprávu, která může být buď předdefinovaný typ, například Message, Stream nebo XElement, nebo kontrakt dat definovaný aplikací, kontrakt zprávy nebo XML třídy, které lze serializovat.
Aktivita Příjmu
Aktivita Receive může přijímat jednu položku nebo více položek v závislosti na typu použitého obsahu příjmu. Aktivita SendReply může být vázána na Receive aktivitu, která přijímá zprávu jako součást vzoru výměny zpráv požadavků/odpovědí ve službě.
Použití Návrháře aktivity Receive
V kategorii Zasílání zpráv na panelu nástrojů přejděte do návrháře aktivit příjmu. Návrhář aktivity Přijmout lze přetáhnout z panelu nástrojů a přetáhnout na plochu Návrhář pracovního postupu všude, kde jsou obvykle umístěny aktivity. Tím se Receive vytvoří aktivita s výchozím nastavením DisplayName Příjmu. Lze DisplayName upravit v záhlaví návrháře aktivity Receive nebo v poli DisplayName mřížky vlastností.
Chcete-li vytvořit SendReply aktivitu a svázat ji s vybranou Receive aktivitou, klikněte pravým tlačítkem myši na návrhář aktivity Přijmout, klepněte na položku SendReply v místní nabídce a návrhář SendReplyToReceive se zobrazí pod návrhářem příjmu. Aktivita SendReply je aktivita, která odesílá zprávu odpovědi jako součást vzoru výměny zpráv požadavků a odpovědí ve službě. Dá se nakonfigurovat pomocí Návrháře SendReplyToReceive .
Případně můžete použít návrhář šablony ReceiveAndSendReply v kategorii Zasílání zpráv sady nástrojů k vytvoření dvojice předem nakonfigurovaných Receive a SendReply aktivit. Další informace o použití ReceiveAndSendReply a SendReplyToReceive šablony, naleznete v tématu ReceiveAndSendReply.
Vlastnosti aktivity Příjmu
Následující tabulka ukazuje Receive vlastnosti a popisuje, jak se používají v návrháři. Tyto vlastnosti lze upravit v mřížce vlastností nebo na ploše Návrháře pracovního postupu. Jedinou požadovanou vlastností je OperationName vlastnost.
| Název vlastnosti | Požaduje se | Využití |
|---|---|---|
| DisplayName | False | Určuje popisný název Receive aktivity. Výchozí hodnota je Receive. I když použití jiné než výchozí hodnoty pro popisnou DisplayName hodnotu není striktně povinné, je osvědčeným postupem použít takovou hodnotu. |
| OperationName | True | Určuje název operace služby implementované touto Receive aktivitou. Tato vlastnost slouží k vytvoření výchozí hodnoty pro action vlastnost, pokud action vlastnost není explicitně nastavena. |
| ServiceContractName | False | Určuje název kontraktu služby. Tato vlastnost se používá k seskupení operací služby do jednotlivých kontraktů služeb. Všechny Receive aktivity, které mají stejné ServiceContractName , jsou seskupeny do stejného kontraktu služby (typ portu WSDL). Výchozí hodnota je plně kvalifikovaný název CLR aktivity nejvyšší úrovně (root). |
| Content | False | Určuje obsah zprávy nebo parametru, který se má přijmout. Může to být ReceiveMessageContent aktivita nebo ReceiveParametersContent aktivita. Tuto vlastnost upravte tak, že vyberete tlačítko se třemi tečkou vedle pole Obsah v mřížce vlastností nebo kliknete na tlačítko Definovat... vedle popisku obsahu na ploše návrháře aktivity Receive. Obě zobrazují dialogové okno Definice obsahu. Další informace o použití tohoto pole naleznete v tématu dialogového okna Definice obsahu. |
| CorrelatesOn | False | Určuje korelace mezi Receive aktivitami v operacích služby pracovního postupu s objektem MessageQuerySet . Kliknutím na tlačítko se třemi tečkami vedle CorrelatesOn vlastnosti v mřížce vlastností otevřete dialogové okno Korelační definice . Další informace o použití tohoto dialogového okna naleznete v tématu Dialogové okno Definice obsahu. |
| CorrelatesWith | False | Určuje použitou CorrelationHandle ke směrování zprávy do příslušné instance pracovního postupu. Kliknutím na tlačítko se třemi tečky vedle CorrelatesWith vlastnosti v mřížce vlastností otevřete dialogové okno Editor výrazů. Další informace o použití tohoto dialogového okna naleznete v tématu Postupy: Použití tématu Editor výrazů. |
| CorrelationInitializers | False | Určuje kolekci CorrelationInitializer objektů, které inicializují více CorrelationHandle objektů, které tuto aktivitu konfigurují Receive v rámci pracovního postupu. Kliknutím na tlačítko se třemi tečkami vedle CorrelationInitializers vlastnosti v mřížce vlastností otevřete dialogové okno Přidat inicializátory korelace. Další informace o použití tohoto pole naleznete v tématu Přidat correlationInitializers Dialog Box . |
| CanCreateInstance | False | Určuje hodnotu, která určuje, zda je vytvořena nová instance pracovního postupu pro zpracování zprávy, pokud zpráva neodpovídá existující instanci pracovního postupu. Pokud je hodnota nastavena na hodnotu true, vytvoří se nová instance pracovního postupu pro zpracování zprávy, pokud zpráva neodpovídá existující instanci pracovního postupu. |
| KnownTypes | False | Určuje kolekci známých typů pro operaci služby implementovanou touto Receive aktivitou. Tato vlastnost by měla být použita ve spojení s vlastností nastavenou SerializerOption na DataContractSerializer. Pokud se používá, ignoruje XmlSerializer se. Výběrem tlačítka se třemi tečkami vedle pole PoleTypes v mřížce vlastností zobrazíte dialogové okno Editor kolekce typů, pomocí kterého můžete přidat relevantní typy. Další informace o použití tohoto pole naleznete v tématu dialogového okna Editor kolekcí typů. |
| ProtectionLevel | False | Určuje ProtectionLevel zprávu. 1. ProtectionLevel znamená pouze ověřování. 2. ProtectionLevel znamená podepsaná data, která pomáhají zajistit integritu přenášených dat. 3. ProtectionLevel znamená šifrování a podepisování dat, které pomáhají zajistit důvěrnost a integritu přenášených dat. |
| SerializerOption | False | Určuje typ serializátoru, který se má použít pro operaci služby implementované aktivitou Receive . Výchozí hodnota je DataContractSerializer, který serializuje a deserializuje instanci typu do datového proudu XML nebo dokumentu, který používá zadaný datový kontrakt. Lze XmlSerializer ho použít také v případě, že je pro XML vyžadováno větší řízení. |
| Action | False | Určuje záhlaví akce zprávy. Pokud není explicitně nastavena, jeho hodnota je výchozí hodnota: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}. |