Sdílet prostřednictvím

Vývoj služby pracovního postupu s upřednostněním kontraktu

  • Článek

Počínaje rozhraním .NET Framework 4.5 nabízí Windows Workflow Foundation (WF) lepší integraci mezi webovými službami a pracovními postupy ve formě vývoje pracovních postupů založených na kontraktech. Nástroj pro vývoj pracovních postupů pro kontrakty umožňuje nejprve navrhnout kontrakt v kódu. Nástroj pak automaticky vygeneruje šablonu aktivity v sadě nástrojů pro operace ve smlouvě. Toto téma obsahuje přehled o tom, jak se aktivity a vlastnosti ve službě pracovního postupu mapují na atributy kontraktu služby. Podrobný příklad vytvoření služby pracovního postupu prvního kontraktu najdete v tématu Postupy: Vytvoření služby pracovního postupu, která využívá existující kontrakt služby.

V tomto tématu

Mapování atributů kontraktů služby na atributy pracovního postupu

Tabulky v následujících částech určují různé atributy a vlastnosti WCF a způsob jejich mapování na aktivity a vlastnosti zasílání zpráv v pracovním postupu prvního kontraktu.

Atributy kontraktů služeb

Název vlastnosti Podporováno Popis Ověřování WF
CallbackContract No Získá nebo nastaví typ zpětného volání kontrakt, když kontrakt je duplexní kontrakt. (Není k dispozici)
ConfigurationName No Získá nebo nastaví název použitý k vyhledání služby v konfiguračním souboru aplikace. (Není k dispozici)
HasProtectionLevel Ano Získá hodnotu, která označuje, zda člen má přiřazenou úroveň ochrany. Receive.ProtectionLevel by neměl mít hodnotu null.
Název Ano Získá nebo nastaví název pro <portType> element v WsDL (Web Services Description Language). Receive.ServiceContractName.LocalName by se měl shodovat.
Obor názvů Ano Získá nebo nastaví obor názvů <elementu portType> v jazyku WSDL (Web Services Description Language). Hodnota Receive.ServiceContractName.NameSpace by se měla shodovat
Úroveň ochrany Ano Určuje, zda vazba pro kontrakt musí podporovat hodnotu ProtectionLevel vlastnost. Receive.ProtectionLevel by se měl shodovat.
SessionMode No Získá nebo nastaví, zda jsou relace povoleny, nejsou povoleny nebo požadovány. (Není k dispozici)
TypeId No Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento atribut. (Zděděno z atributu.) (Není k dispozici)

Sem vložte text pododdílu.

Atributy kontraktu operace

Název vlastnosti Podporováno Popis Ověřování WF
Akce Ano Získá nebo nastaví akci WS-Adresování zprávy požadavku. Akce Receive.Action by se měla shodovat.
AsyncPattern No Označuje, že operace se implementuje asynchronně pomocí dvojice metod BeginName<> a End<methodName> ve smlouvě služby. (Není k dispozici)
HasProtectionLevel Ano Získá hodnotu, která označuje, zda zprávy pro tuto operaci musí být šifrované, podepsané nebo obojí. Receive.ProtectionLevel by neměl mít hodnotu null.
IsInitiating No Získá nebo nastaví hodnotu, která označuje, zda metoda implementuje operaci, která může zahájit relaci na serveru (pokud taková relace existuje). (Není k dispozici)
IsOneWay Ano Získá nebo nastaví hodnotu, která určuje, zda operace vrací zprávu odpovědi. (Pro toto přijetí není k dispozici žádná odpověď SendReply nebo žádná akce ReceiveReply pro toto odeslání).
IsTerminating No Získá nebo nastaví hodnotu, která určuje, zda operace služby způsobí ukončení relace po odeslání zprávy odpovědi, pokud existuje. (Není k dispozici)
Název Ano Získá nebo nastaví název operace. Receive.OperationName by se měl shodovat.
Úroveň ochrany Ano Získá nebo nastaví hodnotu, která určuje, zda zprávy operace musí být šifrované, podepsané nebo obojí. Receive.ProtectionLevel by se měl shodovat.
ReplyAction Ano Získá nebo nastaví hodnotu akce SOAP pro odpověď zprávy operace. SendReply.Action by se měl shodovat.
TypeId No Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento atribut. (Zděděno z atributu.) (Není k dispozici)

Atributy kontraktu zpráv

Název vlastnosti Podporováno Popis Ověřování WF
HasProtectionLevel Ano Získá hodnotu, která označuje, zda zpráva má úroveň ochrany. Žádné ověření (Receive.Content a SendReply.Content musí odpovídat typu kontraktu zprávy).
IsWrapped Ano Získá nebo nastaví hodnotu, která určuje, zda text zprávy má element obálky. Žádné ověření (Receive.Content a Sendreply.Content musí odpovídat typu kontraktu zprávy).
Úroveň ochrany No Získá nebo nastaví hodnotu, která určuje, zda zpráva musí být šifrovaná, podepsaná nebo obojí. (Není k dispozici)
TypeId Ano Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento atribut. (Zděděno z atributu.) Žádné ověření (Receive.Content a SendReply.Content musí odpovídat typu kontraktu zprávy).
WrapperName Ano Získá nebo nastaví název obálky elementu textu zprávy. Žádné ověření (Receive.Content a SendReply.Content musí odpovídat typu kontraktu zprávy).
WrapperNamespace No Získá nebo nastaví obor názvů elementu textu zprávy. (Není k dispozici)

Atributy kontraktu dat

Název vlastnosti Podporováno Popis Ověřování WF
IsReference No Získá nebo nastaví hodnotu, která určuje, zda chcete zachovat odkaz na objekt data. (Není k dispozici)
Název Ano Získá nebo nastaví název datového kontraktu pro typ. Žádné ověření (Receive.Content a SendReply.Content musí odpovídat typu kontraktu zprávy).
Obor názvů Ano Získá nebo nastaví obor názvů pro datový kontrakt pro typ. Žádné ověření (Receive.Content a SendReply.Content musí odpovídat typu kontraktu zprávy).
TypeId No Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento atribut. (Zděděno z atributu.) (Není k dispozici)

Atributy kontraktu selhání

Název vlastnosti Podporováno Popis Ověřování WF
Akce Ano Získá nebo nastaví akci chybové zprávy PROTOKOLU SOAP, která je určena jako součást kontraktu operace. SendReply.Action by se měl shodovat.
DetailType Ano Získá typ serializovatelné objektu, který obsahuje informace o chybě. SendReply.Content by se měl shodovat s typem
HasProtectionLevel No Získá hodnotu, která označuje, zda chybová zpráva SOAP má přiřazenou úroveň ochrany. (Není k dispozici)
Název No Získá nebo nastaví název chybové zprávy v wsDL (Web Services Description Language). (Není k dispozici)
Obor názvů No Získá nebo nastaví obor názvů chyby SOAP. (Není k dispozici)
Úroveň ochrany No Určuje úroveň ochrany, která chyba SOAP vyžaduje z vazby. (Není k dispozici)
TypeId No Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento atribut. (Zděděno z atributu.) (Není k dispozici)

Další informace o podpoře a implementaci

Nepodporované funkce kontraktů služeb

  • Použití úkolů TPL (Task Parallel Library) v kontraktech není podporováno.

  • Dědičnost kontraktů služeb není podporována.

Generování nakonfigurovaných aktivit zasílání zpráv

Do těchto aktivit se přidají Receive dvě veřejné statické metody, SendReply které podporují generování předem nakonfigurovaných aktivit zpráv při použití služeb pracovního postupu prvního kontraktu.

Aktivita generovaná těmito metodami by měla předat ověření kontraktu, a proto se tyto metody používají interně jako součást ověřovací logiky pro Receive a SendReply. Jsou OperationNamepředem nakonfigurované tak, KnownTypes ServiceContractNameActionSerializerOptionProtectionLevelaby odpovídaly importovanému kontraktu. Na stránce vlastností obsahu pro aktivity v návrháři pracovního postupu jsou oddíly Zpráva nebo Parametry také předem nakonfigurované tak, aby odpovídaly smlouvě.

Kontrakty chyb WCF se také zpracovávají vrácením samostatné sady nakonfigurovaných SendReply aktivit pro každou chybu, která se zobrazí v Faults FaultDescriptionCollectionsouboru .

V případě jiných částí OperationDescription , které služby WF dnes nepodporují (například chování WebGet/WebInvoke nebo chování vlastních operací), rozhraní API tyto hodnoty v rámci generování a konfigurace ignoruje. Nebudou vyvolány žádné výjimky.