如何配置 WCF-Custom 接收点

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

配置属性

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

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

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

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

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

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

1. 如果计划在配置 WCF-Custom 适配器时使用 WCF 扩展点（如自定义绑定元素、自定义行为元素和自定义通道组件），则必须将实现扩展点的程序集和所有依赖程序集添加到 BizTalk 处理计算机（运行时计算机）和管理计算机上的全局程序集缓存中。 此外，必须将扩展组件注册到 machine.config 文件。 有关如何将 WCF 扩展点与 WCF 自定义适配器配合使用的详细信息，请参阅 如何使用 WCF 适配器启用 WCF 扩展点。

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

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

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

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

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

7. 在 “WCF-Custom 传输属性 ”对话框中的“ 绑定 ”选项卡上，为 WCF 配置不同类型的预定义或自定义绑定。 有关“WCF-Custom 传输属性”对话框中的“绑定”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-Custom 传输属性”对话框、“接收”、“绑定”选项卡。

8. 在 “WCF-Custom 传输属性 ”对话框中的“ 行为 ”选项卡上，为此接收位置配置终结点和服务行为。 终结点行为是一组修改或扩展服务或客户端功能的行为扩展元素。 有关“WCF-Custom 传输属性”对话框中的“行为”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-Custom 传输属性”对话框、“接收”、“行为”选项卡。

9. 在 “WCF-Custom 传输属性 ”对话框中的 “其他 ”选项卡上，配置轮询外部服务时要使用的此接收位置的凭据，以及此接收位置在处理消息时是否保留消息顺序。 有关“WCF-Custom 传输属性”对话框中的“其他”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-Custom 传输属性”对话框、“接收”、“其他”选项卡。

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

11. 在“WCF-Custom 传输属性”对话框中的“导入/导出”选项卡上，导入和导出“常规”选项卡上的“地址”（URI）和“终结点标识”属性、绑定信息以及此接收位置的“行为”选项卡上的终结点行为。 有关“WCF-Custom 传输属性”对话框中的“导入/导出”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-Custom 传输属性”对话框、“接收”、“导入-导出”选项卡。

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

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

<CustomProps>
  <InboundBodyPathExpression vt="8" />
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <BindingConfiguration vt="8"><binding name="netNamedPipeBinding"><security mode="None" /></binding></BindingConfiguration>
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
  <CredentialType vt="8">GetCredentials</CredentialType>
  <Identity vt="8" />
  <ServiceBehaviorConfiguration vt="8"><behavior name="SampleServiceBehavior"><serviceMetadata httpGetEnabled="true" httpGetUrl="http://mycomputer:9995/SampleService/Mex" /><serviceCredentials /></behavior></ServiceBehaviorConfiguration>
  <Password vt="1" />
  <OrderedProcessing vt="11">-1</OrderedProcessing>
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
  <AffiliateApplicationName vt="8">SampleAffiliateApplication</AffiliateApplicationName>
  <DisableLocationOnFailure vt="11">0</DisableLocationOnFailure>
  <SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
  <BindingType vt="8">netNamedPipeBinding</BindingType>
  <UserName vt="8">Hello</UserName>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <EndpointBehaviorConfiguration vt="8"><behavior name="EndpointBehavior" /></EndpointBehaviorConfiguration>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>

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

// Use BizTalk Explorer object model to create new WCF-Custom 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>
  <BindingConfiguration vt=""8""><binding name=""netNamedPipeBinding""><security mode=""None"" /></binding></BindingConfiguration>
  <BindingType vt=""8"">netNamedPipeBinding</BindingType>
</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 = "SampleBizTalkApplication";
// 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-Custom
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
    if("WCF-Custom" == explorer.ReceiveHandlers[i].TransportType.Name)
        break;
}
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];
receiveLocation.Address = "net.pipe://mycomputer/samplePipeName";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-Custom"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();

另请参阅

发布用于 WCF 接收适配器的服务元数据管理 BizTalk 主机和主机实例如何更改服务帐户和密码安装 WCF 适配器的证书为 WCF 适配器指定消息正文配置 WCF-Custom 适配器如何创建关联应用程序endpointBehaviors 的行为<><><>serviceBehaviors 的行为<><>