以编程方式创建接收位置和发送端口
以编程方式配置 WCF-BasicHttp 接收位置和发送端口。 若要使用 BizTalk 管理控制台,请参阅 WCF-BasicHttp 适配器。
以编程方式配置接收位置
使用 BizTalk 浏览器对象模型,您可以通过编程方式创建和配置接收位置。 BizTalk 资源管理器对象模型公开具有 TransportTypeData 读/写属性的IReceiveLocation 接收位置配置接口。 此属性以 XML 字符串的名称-值对形式接受 WCF-BasicHttp 接收位置配置属性包。 若要在 BizTalk 资源管理器对象模型中设置此属性,必须设置 IReceiveLocation 接口的 InboundTransportLocation 属性。
无需设置 IReceiveLocation 接口的 TransportTypeData 属性。 如果未设置该属性,则 WCF-BasicHttp 适配器将使用 WCF-BasicHttp 接收位置配置的默认值,如下表所示。
以下代码片段演示如何使用 BizTalk 资源管理器对象模型创建 WCF-BasicHttp 接收位置:
// Use BizTalk Explorer object model to create new WCF-BasicHttp 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 = "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-BasicHttp
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
if("WCF-BasicHttp" == 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-BasicHttp"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();
可以使用以下格式在 中 <CustomProps>
设置属性:
<CustomProps>
<ServiceCertificate vt="8" />
<InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
<UseSSO vt="11">0</UseSSO>
<MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
<InboundBodyPathExpression vt="8" />
<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>
<Identity vt="8">
<identity>
<userPrincipalName value="username@contoso.com" />
</identity>
</Identity>
<AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
<SecurityMode vt="8">None</SecurityMode>
<TransportClientCredentialType vt="8">None</TransportClientCredentialType>
<MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
<TextEncoding vt="8">utf-8</TextEncoding>
<CloseTimeout vt="8">00:01:00</CloseTimeout>
<SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
<InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
<IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
<MaxConcurrentCalls vt="3">16</MaxConcurrentCalls>
<MessageEncoding vt="8">Text</MessageEncoding>
<OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>
下表列出了可以为接收位置设置的配置属性:
属性名称 | 类型 | 说明 |
---|---|---|
标识 | XML Blob 示例: <identity> <userPrincipalName value=“username@contoso.com” /> </身份> |
指定此接收位置提供的服务的标识。 可为 Identity 属性指定的值因安全配置而异。 通过这些设置,客户端可对此接收位置进行验证。 在客户端与服务进行握手的过程中,Windows Communication Foundation (WCF) 基础结构将确保预期服务的标识与此元素的值保持一致。 默认值为空字符串。 |
OpenTimeout | System.TimeSpan | 指定一个时间跨度值来表示为完成信道打开操作提供的时间间隔。 默认值:00:01:00 |
SendTimeout | System.TimeSpan | 指定一个时间跨度值来表示为完成发送操作提供的时间间隔。 如果使用请求-响应接收端口,则此值指定完成整个交互的时间跨度(即使客户端返回一条大消息)。 默认值:00:01:00 |
CloseTimeout | System.TimeSpan | 指定一个时间跨度值来表示为完成信道关闭操作提供的时间间隔。 默认值:00:01:00 |
MaxReceivedMessageSize | Integer | 指定网络上可接收的消息的最大大小(包括标头),以字节为单位。 消息的大小受为每条消息分配的内存量的限制。 你可以使用此属性来降低受拒绝服务 (DoS) 攻击的可能性。 WCF-BasicHttp 适配器利用缓冲传输模式下的 BasicHttpBinding 类与终结点通信。 对于缓冲传输模式, BasicHttpBinding.MaxBufferSize 属性始终等于此属性的值。 默认值:65536 |
MessageEncoding | 枚举 - 文本 - 使用短信编码器。 - Mtom - 使用消息传输优化机制 1.0 (MTOM) 编码器。 |
指定用于对 SOAP 消息进行编码的编码器。 默认值: 文本 |
TextEncoding | 枚举 - unicodeFFF - Unicode BigEndian 编码。 - utf-16 - 16 位编码。 - utf-8 - 8 位编码 |
指定在 MessageEncoding 属性设置为 Text 时用于在绑定上发出消息的字符集编码。 默认值: utf-8 |
MaxConcurrentCalls | Integer | 指定针对单个服务实例的并发调用的数目。 超出此限制的调用将在队列中排队。 此属性的范围为 1 到 Int32.MaxValue。 默认值:200 |
SecurityMode | 枚举 - 无 - 消息 - 运输 - TransportWithMessageCredential - TransportCredentialOnly 有关 SecurityMode 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-BasicHttp 传输属性对话框中的“接收、安全性”选项卡中的安全模式属性。 |
指定使用的安全类型。 默认值: 无 |
TransportClientCredentialType | 有关 TransportClientCredentialType 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-BasicHttp 传输属性对话框中的“接收、安全”选项卡中的传输客户端凭据类型属性。 | 指定执行客户端验证时要使用的凭据类型。 默认值: 无 |
MessageClientCredentialType | 枚举 - 用户 - 证书 有关 MessageClientCredentialType 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-BasicHttp 传输属性”对话框中的“接收、安全性”选项卡中的“消息客户端凭据类型”属性。 |
指定使用基于消息的安全性对客户端执行验证时所用的凭据类型。 默认值: UserName |
AlgorithmSuite | 枚举 有关 AlgorithmSuite 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-BasicHttp 传输属性对话框中的“接收、安全性”选项卡中的算法套件属性。 |
指定消息加密和密钥包装算法。 这些算法与“安全策略语言”(WS-SecurityPolicy) 规范中指定的算法一致。 默认值: Basic256 |
ServiceCertificate | 字符串 | 为此接收位置指定 X.509 证书的指纹,客户端利用该指纹验证服务。 要用于此属性的证书必须安装在“当前用户”位置的“我的存储”中。 注意: 必须将服务证书安装到承载此接收位置的接收处理程序的用户帐户的 “当前用户 ”位置。 默认值为空字符串。 |
UseSSO | 布尔 | 指定是否使用企业单一登录 (SSO) 检索客户端凭据以颁发 SSO 票证。 有关支持 SSO 的安全配置的详细信息,请参阅 WCF-BasicHttp 传输属性对话框中 的“接收”部分,请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-BasicHttp 接收适配器的企业单一 Sign-On 可支持性”。 默认值:False |
InboundBodyLocation | 枚举 - UseBodyElement - 使用传入消息的 SOAP Body 元素的内容来创建 BizTalk 消息正文部件。 如果 Body 元素具有多个子元素,则只有第一个元素成为 BizTalk 消息正文部分。 - UseEnvelope - 从传入消息的整个 SOAP 信封 创建 BizTalk 消息正文部分。 - UseBodyPath - 使用 InboundBodyPathExpression 属性中的正文路径表达式创建 BizTalk 消息正文部件。 针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。 此属性仅对要求-响应端口有效。 有关如何使用 InboundBodyLocation 属性的详细信息,请参阅 指定 WCF 适配器的消息正文。 |
指定传入 WCF 消息的 SOAP Body 元素的数据选择。 默认值: UseBodyElement |
InboundBodyPathExpression | 字符串 有关如何使用 InboundBodyPathExpression 属性的详细信息,请参阅 WCF 适配器属性架构和属性。 |
指定正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。 此正文路径表达式是针对传入消息的 SOAP 正文 节点的直接子元素计算的。 如果此正文路径表达式返回多个节点,则只选择第一个节点作为 BizTalk 消息正文部分。 如果 InboundBodyLocation 属性设置为 UseBodyPath,则此属性是必需的。 默认值为空字符串。 |
InboundNodeEncoding | 枚举 - Base64 - Base64 编码。 - 十 六进制 - 十六进制编码。 - 字符串 - 文本编码 - UTF-8 - XML - WCF 适配器使用 InboundBodyPathExpression 中的正文路径表达式选择的节点的外部 XML 创建 BizTalk 消息正文。 |
指定 WCF-BasicHttp 接收适配器用于解码 由 InboundBodyPathExpression 中指定的正文路径表达式标识的节点的编码类型。 如果 InboundBodyLocation 属性设置为 UseBodyPath,则此属性是必需的。 默认值: XML |
OutboundBodyLocation | 枚举 - UseBodyElement - 使用 BizTalk 消息正文部件为传出响应消息创建 SOAP Body 元素的内容。 - UseTemplate - 使用 OutboundXMLTemplate 属性中提供的模板为传出响应消息创建 SOAP Body 元素的内容。 有关如何使用 OutboundBodyLocation 属性的详细信息,请参阅 指定 WCF 适配器的消息正文。 |
为传出 WCF 消息的 SOAP Body 元素指定数据选择。 此属性仅对请求响应接收位置有效。 默认值: UseBodyElement |
OutboundXMLTemplate | 字符串 有关如何使用 OutboundXMLTemplate 属性的详细信息,请参阅 指定 WCF 适配器的消息正文。 |
为传出响应消息的 SOAP Body 元素的内容指定 XML 格式的模板。 如果将 OutboundBodyLocation 属性设置为 UseTemplate,则此属性是必需的。 此属性仅对请求响应接收位置有效。 默认值为空字符串。 |
SuspendMessageOnFailure | 布尔 | 指定是否将由于接收管道故障或路由故障而导致入站处理失败的请求消息挂起。 默认值:False |
IncludeExceptionDetailInFaults | 布尔 | 指定是否将托管异常信息包括在返回给客户端以便进行调试的 SOAP 错误的详细信息中。 默认值: False |
以编程方式配置发送端口
以下代码片段演示如何使用 BizTalk 资源管理器对象模型创建 WCF-BasicHttp 发送端口:
// Use BizTalk Explorer object model to create new WCF-BasicHttp send port.
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
string transportConfigData = @"<CustomProps>
<StaticAction vt=""8"">http://www.northwindtraders.com/Service/Operation</StaticAction>
<MessageEncoding vt=""8"">Text</MessageEncoding>
<TextEncoding vt=""8"">utf-8</TextEncoding>
<OpenTimeout vt=""8"">00:01:00</OpenTimeout>
</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 static one-way send port
SendPort sendPort = application.AddNewSendPort(false, false);
sendPort.Name = "SampleSendPort";
sendPort.PrimaryTransport.TransportType = explorer.ProtocolTypes["WCF-BasicHttp"];
sendPort.PrimaryTransport.Address = "http://mycomputer/samplepath";
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Save
explorer.SaveChanges();
可以使用以下格式在 中 <CustomProps>
设置属性:
<CustomProps>
<ServiceCertificate vt="8" />
<InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
<UseSSO vt="11">0</UseSSO>
<MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
<InboundBodyPathExpression vt="8" />
<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">None</SecurityMode>
<TransportClientCredentialType vt="8">None</TransportClientCredentialType>
<ClientCertificate vt="8" />
<ProxyUserName vt="8" />
<MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
<TextEncoding vt="8">utf-8</TextEncoding>
<StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>
<CloseTimeout vt="8">00:01:00</CloseTimeout>
<ProxyToUse vt="8">Default</ProxyToUse>
<InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
<PropagateFaultMessage vt="11">-1</PropagateFaultMessage>
<ProxyAddress vt="8" />
<MessageEncoding vt="8">Text</MessageEncoding>
<OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>
下表列出了可以为发送端口设置的配置属性:
属性名称 | 类型 | 描述 |
---|---|---|
SecurityMode | 枚举 - 无 - 消息 - 运输 - TransportWithMessageCredential - TransportCredentialOnly 有关 SecurityMode 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-BasicHttp 传输属性”对话框中的“发送,安全性”选项卡。 |
指定使用的安全类型。 默认值: 无 |
MessageClientCredentialType | 枚举 - 用户 - 证书 有关 MessageClientCredentialType 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-BasicHttp 传输属性对话框中的“发送,安全性”选项卡中的消息客户端凭据类型属性。 |
指定使用基于消息的安全性对客户端执行验证时所用的凭据类型。 默认值: UserName |
TransportClientCredentialType | 枚举 - 无 - 基本 - Windows - 证书 - 消化 - Ntlm 有关 TransportClientCredentialType 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-BasicHttp 传输属性”对话框中的“发送,安全性”选项卡中的传输客户端凭据类型属性。 |
指定执行发送端口验证时使用的凭据类型。 默认值: 无 |
UserName | String | 当 UseSSO 属性设置为 False 时,指定用于对目标服务器进行身份验证的用户名。 不必采用“域\用户”格式设置此属性。 默认值为空字符串。 |
密码 | 字符串 | 当 UseSSO 属性设置为 False 时,指定用于对目标服务器进行身份验证的密码。 默认值为空字符串。 |
AffiliateApplicationName | 字符串 | 指定用于企业单一登录 (SSO) 的关联应用程序。 默认值为空字符串。 |
UseSSO | 布尔 | 指定是否使用单一登录检索客户端凭据,以便在目标服务器上进行验证。 默认值:False |
ClientCertificate | 字符串 | 指定用于向服务验证此发送端口的 X.509 证书的指纹。 如果 ClientCredentialsType 属性设置为 Certificate,则此属性是必需的。 要用于此属性的证书必须安装在“当前用户”位置的“我的存储”中。 默认值为空字符串。 |
ServiceCertificate | 字符串 | 指定用于验证服务(此发送端口要将消息发送到的服务)的 X.509 证书的指纹。 要用于此属性的证书必须安装到本地计算机位置的“其他人员存储中。 默认值为空字符串。 |
ProxyToUse | 枚举 - 无 - 不对此发送端口使用代理服务器。 - 默认值 - 在承载此发送端口的发送处理程序中使用代理设置。 - UserSpecified - 使用 ProxyAddress 属性中指定的代理服务器 |
指定要用于传出 HTTP 通信的代理服务器。 默认值: 无 |
ProxyAddress | 字符串 | 指定代理服务器的地址。 根据安全配置使用 https 或 http 方案。 此地址后面可跟冒号和端口号。 例如,http://127.0.0.1:8080。 默认值为空字符串。 |
ProxyUserName | 字符串 | 指定用于代理的用户名。 WCF-BasicHttp 适配器利用缓冲传输模式下的 BasicHttpBinding 与终结点通信。 仅当安全模式为 Transport、None 或 TransportCredentialOnly 时,BasicHttpBinding 的代理凭据才适用。 如果将 SecurityMode 属性设置为 Message 或 TransportWithMessageCredential,WCF-BasicHttp 适配器不会使用 ProxyUserName 和 ProxyPassword 属性中指定的凭据对代理进行身份验证。 注意: WCF-BasicHttp 发送适配器对代理使用基本身份验证。 默认值为空字符串。 |
ProxyPassword | 字符串 | 指定用于代理的密码。 默认值为空字符串。 |
InboundBodyLocation | 枚举 - UseBodyElement - 使用传入消息的 SOAP Body 元素的内容来创建 BizTalk 消息正文部件。 如果 Body 元素具有多个子元素,则只有第一个元素成为 BizTalk 消息正文部分。 此属性仅对要求-响应端口有效。 - UseEnvelope - 从传入消息的整个 SOAP 信封 创建 BizTalk 消息正文部分。 - UseBodyPath - 使用 InboundBodyPathExpression 属性中的正文路径表达式创建 BizTalk 消息正文部件。 针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。 此属性仅对要求-响应端口有效。 有关如何使用 InboundBodyLocation 属性的详细信息,请参阅 指定 WCF 适配器的消息正文。 |
指定传入 WCF 消息的 SOAP Body 元素的数据选择。 默认值: UseBodyElement |
OutboundBodyLocation | 枚举 - UseBodyElement - 使用 BizTalk 消息正文部件为传出消息创建 SOAP Body 元素的内容。 - UseTemplate - 使用 OutboundXMLTemplate 属性中提供的模板为传出消息创建 SOAP Body 元素的内容。 有关如何使用 OutboundBodyLocation 属性的详细信息,请参阅 指定 WCF 适配器的消息正文。 |
为传出 WCF 消息的 SOAP Body 元素指定数据选择。 默认值: UseBodyElement |
InboundBodyPathExpression | 字符串 有关如何使用 InboundBodyPathExpression 属性的详细信息,请参阅 WCF 适配器属性架构和属性。 |
指定正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。 此正文路径表达式是针对传入消息的 SOAP 正文 节点的直接子元素计算的。 如果此正文路径表达式返回多个节点,则只选择第一个节点作为 BizTalk 消息正文部分。 如果 InboundBodyLocation 属性设置为 UseBodyPath,则此属性是必需的。 此属性仅对要求-响应端口有效。 默认值为空字符串。 |
OutboundXMLTemplate | 字符串 有关如何使用 OutboundXMLTemplate 属性的详细信息,请参阅 指定 WCF 适配器的消息正文。 |
为传出消息的 SOAP Body 元素的内容指定 XML 格式的模板。 如果将 OutboundBodyLocation 属性设置为 UseTemplate,则此属性是必需的。 默认值为空字符串。 |
InboundNodeEncoding | 枚举 - Base64 - Base64 编码。 - 十 六进制 - 十六进制编码。 - 字符串 - 文本编码 - UTF-8 - XML - WCF 适配器使用 InboundBodyPathExpression 中的正文路径表达式选择的节点的外部 XML 创建 BizTalk 消息正文。 |
指定 WCF-BasicHttp 发送适配器用于解码 由 InboundBodyPathExpression 中指定的正文路径表达式标识的节点的编码类型。 如果 InboundBodyLocation 属性设置为 UseBodyPath,则此属性是必需的。 此属性仅对要求-响应端口有效。 默认值: XML |
StaticAction | 字符串 | 指定传出消息的 SOAPAction HTTP 标头字段。 也可以通过消息上下文属性 WCF 设置此属性 。 管道或业务流程中的操作。 可以通过两种不同的方式指定此值:单一操作格式和操作映射格式。 如果以单个操作格式(例如 )设置此属性, http://contoso.com/Svc/Op1 则传出消息的 SOAPAction 标头始终设置为此属性中指定的值。如果以操作映射格式设置此属性,则传出 SOAPAction 标头由 BTS 确定。操作 上下文属性。 例如,如果此属性设置为以下 XML 格式和 BTS。操作 属性设置为 Op1,WCF 发送适配器将用于 http://contoso.com/Svc/Op1 传出 SOAPAction 标头。<BtsActionMapping> <Operation Name=“Op1” Action=“http://contoso.com/Svc/Op1" /> <Operation Name=“Op2” Action=“http://contoso.com/Svc/Op2" /> </BtsActionMapping> 如果传出消息来自业务流程端口,则业务流程实例会动态设置 BTS。具有 端口的操作名称的 Operation 属性。 如果传出消息使用基于内容的路由进行路由,则可以设置 BTS。 管道组件中的操作属性。 默认值为空字符串。 |
MaxReceivedMessageSize | Integer | 指定网络上可接收的消息的最大大小(包括标头),以字节为单位。 消息的大小受为每条消息分配的内存量的限制。 你可以使用此属性来降低受拒绝服务 (DoS) 攻击的可能性。 WCF-BasicHttp 适配器利用缓冲传输模式下的 BasicHttpBinding 类与终结点通信。 对于缓冲传输模式, BasicHttpBinding.MaxBufferSize 属性始终等于此属性的值。 默认值:65,536 |
MessageEncoding | 枚举 - 文本 - 使用短信编码器。 - Mtom - 使用消息传输组织机制 1.0 (MTOM) 编码器。 |
指定用于对 SOAP 消息进行编码的编码器。 默认值: Text |
TextEncoding | 枚举 - unicodeFFF - Unicode BigEndian 编码。 - utf-16 - 16 位编码。 - utf-8 - 8 位编码 |
指定在 MessageEncoding 属性设置为 Text 时用于在绑定上发出消息的字符集编码。 默认值: utf-8 |
SendTimeout | System.TimeSpan | 指定一个时间跨度值来表示为完成发送操作提供的时间间隔。 如果使用要求-响应发送端口,则此值指定完成整个交互的时间跨度(即使服务返回一条大消息)。 默认值:00:01:00 |
OpenTimeout | System.TimeSpan | 指定一个时间跨度值来表示为完成信道打开操作提供的时间间隔。 默认值:00:01:00 |
CloseTimeout | System.TimeSpan | 指定一个时间跨度值来表示为完成信道关闭操作提供的时间间隔。 默认值:00:01:00 |
AlgorithmSuite | 枚举 有关 AlgorithmSuite 属性的成员名称的详细信息,请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-BasicHttp 传输属性对话框中的“发送、安全性”选项卡中的算法套件属性。 |
指定消息加密和密钥包装算法。 这些算法与“安全策略语言”(WS-SecurityPolicy) 规范中指定的算法一致。 默认值: Basic256 |
标识 | XML Blob 示例: <identity> <userPrincipalName value=“username@contoso.com” /> </身份> |
指定此发送端口预期的服务标识。 这些设置支持此发送端口对服务进行验证。 在客户端与服务进行握手的过程中,Windows Communication Foundation (WCF) 基础结构将确保预期服务的标识与此元素的值保持一致。 默认值为空字符串。 |
PropagateFaultMessage | 布尔 - True - 将出站处理失败的消息路由到订阅应用程序 (,例如另一个接收端口或业务流程计划) 。 - False - 挂起失败的消息, (NACK) 生成否定确认。 |
指定是路由还是挂起在出站处理中失败的消息。 此属性仅对要求-响应端口有效。 默认值: True |
另请参阅
WCF 适配器是什么?使用隔离的 WCF 接收适配器发布 WCF 服务为独立 WCF 接收适配器配置 IIS管理 BizTalk 主机和主机实例如何更改服务帐户和密码为 WCF 适配器安装证书指定 WCF 适配器的消息正文WCF 适配器属性架构和属性配置动态发送端口使用 WCF 适配器上下文属性