如何配置 WCF-WSHttp 接收位置

可以通过编程方式或使用 BizTalk 管理控制台来配置 WCF-WSHttp 接收位置。

配置属性

BizTalk 资源管理器对象模型使你能够以编程方式创建和配置接收位置。 BizTalk 资源管理器对象模型公开IReceiveLocation 接收位置配置接口，该接口具有 TransportTypeData 读/写属性。 此属性接受一个WCF-WSHttp接收位置配置属性包，其形式为XML字符串的名称-值对。 若要在 BizTalk 资源管理器对象模型中设置此属性，必须设置 IReceiveLocation 接口的 InboundTransportLocation 属性。

无需设置 IReceiveLocation 接口的 TransportTypeData 属性。 如果未设置，WCF-WSHttp 适配器将使用 WCF-WSHttp 接收位置配置的默认值，如下表所示。

下表列出了可以在 bizTalk Explorer 对象模型中为 WCF-WSHttp 接收位置设置的配置属性。

使用 BizTalk 管理控制台配置 WCF-WSHttp 接收位置

可以在 BizTalk 管理控制台中设置 WCF-WSHttp 接收位置适配器变量。 如果未在接收位置设置属性，将使用 BizTalk 管理控制台中设置的默认接收处理程序值。

为 WCF-WSHttp 接收位置配置变量

1. 在 BizTalk 管理控制台中，展开 BizTalk Server 管理、BizTalk 组、应用程序，然后展开要在其中创建接收位置的应用程序。

2. 在 BizTalk 管理控制台的左窗格中，单击 “接收端口 ”节点。 然后在右窗格中，右键单击与现有接收位置关联的接收端口或要与新接收位置关联的接收端口，然后单击“ 属性”。

3. 在 “接收端口属性 ”对话框中的左窗格中，选择“ 接收位置”，然后在右窗格中双击现有接收位置，或单击“ 新建”创建新的接收位置。

4. 在“接收位置属性”对话框中，在“类型”旁边的“传输”部分中，从下拉列表中选择 WCF-WSHttp，然后单击“配置”。

5. 在 “WCF-WSHttp 传输属性 ”对话框中的“ 常规 ”选项卡上，为 WCF-WSHttp 接收位置配置终结点地址和服务标识。 有关“WCF-WSHttp 传输属性”对话框中的“常规”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-WSHttp 传输属性”对话框、“接收”、“常规”选项卡。

6. 在 “WCF-WSHttp 传输属性 ”对话框中的“ 绑定 ”选项卡上，配置超时、编码和事务属性。 有关“WCF-WSHttp 传输属性”对话框中的“绑定”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-WSHttp 传输属性”对话框、“接收”、“绑定”选项卡。

7. 在 “WCF-WSHttp 传输属性 ”对话框中的“ 安全 ”选项卡上，定义 WCF-WSHttp 接收位置的安全功能。 有关“WCF-WSHttp 传输属性”对话框中的“安全”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-WSHttp 传输属性”对话框、“接收”、“安全”选项卡。

8. 在 “WCF-WSHttp 传输属性 ”对话框中的“ 消息 ”选项卡上，指定 SOAP 正文 元素的数据选择。 有关“WCF-WSHttp 传输属性”对话框中的“消息”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-WSHttp 传输属性”对话框、“接收”、“消息”选项卡。

以编程方式配置 WCF-WSHttp 接收位置

可以使用以下格式设置属性：

<CustomProps>  
  <InboundBodyPathExpression vt="8" />  
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>  
  <UseSSO vt="11">0</UseSSO>  
  <MessageClientCredentialType vt="8">Windows</MessageClientCredentialType>  
  <SendTimeout vt="8">00:01:00</SendTimeout>  
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>  
  <OpenTimeout vt="8">00:01:00</OpenTimeout>  
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>  
  <SecurityMode vt="8">Message</SecurityMode>  
  <TransportClientCredentialType vt="8">Windows</TransportClientCredentialType>  
  <NegotiateServiceCredential vt="11">-1</NegotiateServiceCredential>  
  <MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>  
  <TextEncoding vt="8">utf-8</TextEncoding>  
  <CloseTimeout vt="8">00:01:00</CloseTimeout>  
  <SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>  
  <EnableTransaction vt="11">0</EnableTransaction>  
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>  
  <EstablishSecurityContext vt="11">-1</EstablishSecurityContext>  
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>  
  <MaxConcurrentCalls vt="3">16</MaxConcurrentCalls>  
  <ServiceCertificate vt="8" />  
  <MessageEncoding vt="8">Text</MessageEncoding>  
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>  
</CustomProps>  

以下代码片段演示如何创建 WCF-WSHttp 接收位置：

// Use BizTalk Explorer object model to create new WCF-WSHttp receive location   
string server = System.Environment.MachineName;  
string database = "BizTalkMgmtDb";  
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);  
string transportConfigData = @"<CustomProps>  
  <InboundBodyLocation vt=""8"">UseBodyElement</InboundBodyLocation>  
  <UseSSO vt=""11"">0</UseSSO>  
  <Identity vt=""8"">  
    <identity>  
    <userPrincipalName value=""username@contoso.com"" />  
    </identity>  
  </Identity>  
</CustomProps>";  
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll  
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();  
explorer.ConnectionString = connectionString;  
// Add a new BizTalk application  
Application application = explorer.AddNewApplication();  
application.Name = "SampleBizTalkApplication1001";  
// Save  
explorer.SaveChanges();  

// Add a new one-way receive port  
IReceivePort receivePort = application.AddNewReceivePort(false);  
receivePort.Name = "SampleReceivePort";  
// Add a new one-way receive location  
IReceiveLocation receiveLocation = receivePort.AddNewReceiveLocation();  
receiveLocation.Name = "SampleReceiveLocation";  
// Find a receive handler for WCF-WSHttp   
int i = 0;  
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)   
{  
    if("WCF-WSHttp" == explorer.ReceiveHandlers[i].TransportType.Name)  
        break;  
}  
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];  
receiveLocation.Address = "/samplepath/sampleservice.svc";  
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];  
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-WSHttp"];  
receiveLocation.TransportTypeData = transportConfigData;  
// Save  
explorer.SaveChanges();   

另请参阅

使用独立 WCF 接收适配器发布 WCF 服务
为独立 WCF 接收适配器配置 IIS
管理 BizTalk 主机和主机实例
如何更改服务帐户和密码
用于 WCF 适配器的证书安装
为 WCF 适配器指定消息体
配置 WCF-WSHttp 适配器