具有已发布 WCF 服务的 SOAP 标头

2025-06-05

WCF 接收适配器可以将入站消息中的所有 SOAP 标头值复制到 InboundHeaders 属性，也可以将指定值写入或提升到 BizTalk 消息上下文。适配器可以处理 WCF 基础结构使用的自定义 SOAP 标头和标准 SOAP 标头，例如 WS 地址、WS-Security 和 WS-AtomicTransaction。 InboundHeaders 上下文属性位于目标命名空间http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties中，并在入站消息中包含 SOAP 标头值的字符串表示形式。

注释

如果要提升指定的 SOAP 标头值，则 BizTalk 项目中必须有一个与所提升的值相对应的已部署属性架构。

注释

升级的属性不能超过 256 个字符。

以下 XML 数据显示了 InboundHeaders 属性的 SOAP 标头的字符串表示形式示例。这来自客户端，并发送到 BizTalk 接收位置。

<headers>
<a:Action s:mustUnderstand="1" xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">Operation_1</a:Action>
<SalesAgent xmlns="Microsoft.Samples.BizTalk.WCF.CustomSoapHeaderPipeline">Contoso</SalesAgent>
<a:MessageID xmlns:a="http://www.w3.org/2005/08/addressing">urn:uuid:26e6720f-5a82-4ef2-b597-6ef077bab92e</a:MessageID>
<a:ReplyTo xmlns:a="http://www.w3.org/2005/08/addressing"><a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address></a:ReplyTo>
<a:To s:mustUnderstand="1" xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">net.tcp://localhost:9990/NetTcpOrderProcess</a:To>
</headers>

若要将 SOAP 标头值写入或提升到 BizTalk 消息上下文，需要将由属性名称和命名空间组成的值对集合放入 WCF 消息中，以便 WCF 适配器能够识别要写入或提升标头值。 WCF 适配器需要 WCF 消息中的以下消息属性，以便将 SOAP 标头值写入或提升到 BizTalk 消息上下文：

若要将 SOAP 标头值提升到 BizTalk 消息上下文，WCF 适配器正在寻找键 http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties/Promote 值对和值 List<KeyValuePair<XmlQualifiedName 对象>>。

使用此对，WCF 适配器从 XmlQualifiedName 对象获取命名空间、名称和值，并将它们用于提升标头值。
若要将 SOAP 标头值写入，但不将 SOAP 标头值提升到 BizTalk 消息上下文，WCF 适配器正在寻找键 http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties/WriteToContext 值对和值 List<KeyValuePair<XmlQualifiedName 对象>>。

使用此对，WCF 适配器会将值写入消息上下文。

以下代码演示如何将 SOAP 标头值写入或提升到 BizTalk 消息上下文：

const string PropertiesToPromoteKey="http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties/Promote";
const string PropertiesToWriteKey="http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties/WriteToContext";

XmlQualifiedName PropName1=new XmlQualifiedName("Destination", "http://tempuri.org/2007/sample-properties");
XmlQualifiedName PropName2=new XmlQualifiedName("Source", "http://tempuri.org/2007/sample-properties");

//Create a List of KeyValuePairs that indicate properties to be promoted to BizTalk message context.
//A Property Schema must be deployed and string values have a limit of 256 characters
List<KeyValuePair<XmlQualifiedName, object>> promoteProps=new List<KeyValuePair<XmlQualifiedName, object>>();
promoteProps.Add(new KeyValuePair<XmlQualifiedName, object>(PropName1, "Property value"));
wcfMessage.Properties[PropertiesToPromoteKey]=promoteProps;

//Create a List of KeyValuePairs that indicate properties to be written to BizTalk message context
List<KeyValuePair<XmlQualifiedName, object>> writeProps=new List<KeyValuePair<XmlQualifiedName, object>>();
writeProps.Add(new KeyValuePair<XmlQualifiedName, object>(PropName2, "Property value"));
wcfMessage.Properties[PropertiesToWriteKey]=writeProps;

BizTalk WCF 服务发布向导不包括生成的元数据中的自定义 SOAP 标头定义。若要使用自定义 SOAP 标头发布 WCF 服务的元数据，应手动创建 Web 服务描述语言（WSDL）文件。可以在向导生成的 Web.config 文件中使用 serviceMetadata 元素的<externalMetadataLocation> 属性来指定 WSDL 文件的位置。 WSDL 文件将返回给用户，以响应 WSDL 和元数据交换（MEX）请求，而不是自动生成的 WSDL。

以下 XML 数据显示了定义自定义 SOAP 标头的 WSDL 文件的一部分的示例：

<wsdl:operation name="Request">
  <soap12:operation soapAction="http://Microsoft.Samples.BizTalk.NetTcpAdapter/OrderProcess/IOrderProcess/Request" style="document" />
   <wsdl:input name="Order">
     <soap12:header message="i0:Order_Headers" part="SalesAgent" use="literal" />
     <soap12:body use="literal" />
   </wsdl:input>
   <wsdl:output name="OrderConfirmation">
     <soap12:header message="i0:OrderConfirmation_Headers" part="PaymentAgent" use="literal" />
     <soap12:body use="literal" />
   </wsdl:output>
</wsdl:operation>

本节中

另请参阅

WCF 适配器属性架构和属性已使用的 WCF 服务的 SOAP 标头

通过

具有已发布 WCF 服务的 SOAP 标头

本节中

另请参阅

反馈

其他资源