Freigeben über

Verwenden von SOAP-Headern in WCF-Nachrichten mit Orchestrierungen

  • Artikel

Um die benutzerdefinierten SOAP-Header mit ausgehenden WCF-Nachrichten in Orchestrierungen zu senden, verwenden Sie die Kontexteigenschaft WCF. OutboundCustomHeaders. Die WCF-Adapter senden die benutzerdefinierten SOAP-Header, kombiniert mit den SOAP-Standardheadern, die in der WCF-Infrastruktur für Webdienststandards wie WS-Addressing, WS-Security und WS-AtomicTransaction verwendet werden. Wenn Sie die OutboundCustomHeaders-Eigenschaft verwenden, muss die Eigenschaft das <headers-Element> als Stammelement aufweisen. Alle benutzerdefinierten SOAP-Header müssen innerhalb des <headers-Elements> platziert werden. Wenn der benutzerdefinierte SOAP-Headerwert eine leere Zeichenfolge ist, müssen Sie der OutboundCustomHeaders-EigenschaftHeader></><Header> zuweisen<.

Bei Orchestrierungen werden die Kontexteigenschaften von SOAP-Headern auf Zeichenfolgen festgelegt, die XML-Daten enthalten. Sie legen diese Zeichenfolgen mithilfe des BizTalk-Ausdrucks-Editors in einer Nachrichtenzuweisungs- oder Ausdrucksform fest. Weitere Informationen zur Verwendung von SOAP-Headern mit den WCF-Adaptern finden Sie im SDK-Beispiel Verwenden von benutzerdefinierten SOAP-Headern mit den WCF-Adaptern von https://go.microsoft.com/fwlink/?LinkId=79960.

Im nachstehenden Beispiel (aus einer Form vom Typ Nachrichtenzuordnung oder Ausdruck) wird gezeigt, wie die Kontexteigenschaft von der Zeichenfolge festgelegt wird.

outboundMessageInstance(WCF.OutboundCustomHeaders) = "<headers><Origination>Home</Origination><Destination>Work</Destination></headers>"

Erstellen eines XMLDocument, um Kontexteigenschaften festzulegen

Sie können den WCF festlegen. OutboundCustomHeaders-Kontexteigenschaft durch Erstellen eines XmlDocument und Schreiben des Zeichenfolgenwerts des XmlDocument in die context-Eigenschaft. Sie deklarieren eine Variable vom Typ XMLDocument und weisen die XML-Daten zu.

Das folgende Beispiel zeigt das Deklarieren einer Variablen vom Typ XMLDocument und das Zuweisen der XML-Daten:

xmlDoc.LoadXml("<headers><Origination>Home</Origination><Destination>Work</Destination></headers>");

Im folgenden Beispiel wird gezeigt, wie die Kontexteigenschaft festgelegt wird:

RequestMessageInstance(WCF.OutboundCustomHeaders) = xmlDoc.OuterXml;

Weitere Informationen zur Verwendung des BizTalk-Ausdrucks-Editors finden Sie unter Anforderungen und Einschränkungen für Ausdrücke. Weitere Informationen zum Aufrufen von .NET-Klassen finden Sie unter Erstellen von Nachrichten im Benutzercode.

Weitere Informationen

WCF Adapters-Eigenschaftenschema und EigenschaftenSOAP-Header mit verbrauchten WCF-DienstenSOAP-Headern mit veröffentlichten WCF-Diensten