WCF 适配器属性架构和属性

项目
10/14/2023

了解 WCF 适配器属性架构中的升级属性。 WCF 适配器对应用程序中可使用的属性进行赋值。 WCF 适配器还提供了一种用于将自定义属性写入 BizTalk 消息上下文但不进行升级的机制，以及一种用于将自定义属性升级到 BizTalk 消息上下文的机制。有关详细信息，请参阅具有已发布 WCF 服务的 SOAP 标头。

提升的属性

命名空间：

操作

为传出消息指定 SOAPAction 标头字段。可以通过两种不同的方式指定此值：单个操作格式和操作映射格式。如果以单一操作格式（例如）设置此属性， http://contoso.com/Svc/Op1 则传出消息的 SOAPAction 标头始终设置为此属性中指定的值。

如果以操作映射格式设置此属性，则传出 SOAPAction 标头由 BTS 确定。操作 上下文属性。例如，如果此属性设置为以下 XML 格式和 BTS。Operation 属性设置为 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。 管道组件中的操作属性。此属性将自动从传入消息以单一操作格式进行升级。

类型：字符串默认值：空字符串适用于：所有 WCF 发送适配器

AffiliateApplicationName

指定用于企业单一登录 (SSO) 的关联应用程序。如果将 UseSSO 属性设置为 True，则此属性是必需的。

类型：字符串默认值：空字符串适用于：除 WCF-NetNamedPipe 适配器之外的所有 WCF 发送适配器

AlgorithmSuite

指定消息加密和密钥包装算法。这些算法与“安全策略语言”(WS-SecurityPolicy) 规范中指定的算法一致。

有关 AlgorithmSuite 属性的适用值的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-NetTcp 传输属性对话框“发送、安全性”选项卡中的算法套件属性。

类型：字符串默认值： Basic256 适用于：

WCF-BasicHttp 适配器
WCF-NetMsmq 适配器
WCF-NetTcp 适配器
WCF-WSHttp 适配器

BindingConfiguration

指定包含绑定>元素的< XML 字符串，以配置 Windows Communication Foundation (WCF) 提供的不同类型的预定义绑定。有关系统提供的绑定和自定义绑定的详细信息，请参阅“另请参见”部分中的相应主题。

例如：

<binding name="wsHttpBinding" transactionFlow="true">
<security><message clientCredentialType="UserName"></security>
</binding>

类型：字符串默认值：空字符串适用于：WCF-Custom 适配器、WCF-CustomIsolated 适配器

BindingType

指定要用于终结点的绑定类型。有关 BindingType 属性的适用值的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-自定义传输属性”对话框中的“发送、绑定”选项卡中的“绑定类型”属性。

类型：字符串默认值：空字符串适用于：WCF-Custom 适配器、WCF-CustomIsolated 适配器

ClientCertificate

指定用于向服务验证此发送端口的 X.509 证书的指纹。如果 ClientCredentialsType 属性设置为 Certificate，则此属性是必需的。要用于此属性的证书必须安装到“当前用户”位置的“我的存储”中。

类型：字符串默认值：空字符串适用于：

WCF-BasicHttp 发送适配器
WCF-WSHttp 发送适配器
WCF-NetTcp 发送适配器
WCF-NetMsmq 发送适配器

CloseTimeout

指定一个时间跨度值来表示为完成信道关闭操作提供的时间间隔。

类型：字符串默认值：00：01：00 适用范围：除 WCF-Custom 和 WCF-CustomIsolated

CustomDeadLetterQueue

使用 net.msmq 方案为每个应用程序死信队列的位置指定完全限定的 URI，其中放置了已过期或传输或传递失败的消息。例如 net.msmq://localhost/deadLetterQueueName。死信队列是发送应用程序的队列管理器中的一个队列，用于放置传递失败的过期消息。如果将 DeadLetterQueue 属性设置为 Custom，则此属性是必需的。

类型：字符串默认值：空字符串应用于：WCF-NetMsmq 发送适配器

DeadLetterQueue

指定死信队列，未能传输到应用程序的消息将传输到死信队列中。有关传递到死信队列的消息的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-NetMsmq 传输属性对话框、发送、绑定选项卡。

类型：字符串默认值：系统应用于：WCF-NetMsmq 发送适配器

DisableLocationOnFailure

指定是否禁用由于接收管道故障或路由故障而导致入站处理失败的接收位置。如果可以禁用接收位置且不考虑拒绝服务 (DoS) ，则可能需要将此属性设置为 True 。

例如：

WCF-Custom 适配器：当 BindingType 属性设置为 netMsmqBinding 时。
WCF-Custom 适配器：当 BindingType 属性设置为 customBinding，并且 BindingConfiguration 属性配置为使用依赖于排队传输（如 MSMQ）的自定义通道时。
WCF-CustomIsolated 适配器：当 BindingType 属性设置为 customBinding，并且 BindingConfiguration 属性配置为使用依赖于排队传输（如 MSMQ）的自定义通道时
WCF-NetMsmq 适配器

类型：布尔值默认值： False 适用于：

WCF-NetMsmq 接收适配器
WCF-Custom 接收适配器
WCF-CustomIsolated 接收适配器

EnableTransaction

此属性的效果依 WCF 适配器的不同而变化。有关此属性的详细信息，请参阅 WCF 适配器中每个 WCF 适配器的操作方法主题。

类型：布尔值适用于：

WCF-WSHttp 适配器
WCF-NetTcp 适配器
WCF-NetNamedPipe 适配器
WCF-NetMsmq 适配器

EndpointBehaviorConfiguration

使用 endpointBehaviors> 元素的行为元素<指定 XML 字符串，以配置 WCF 终结点的行为设置。>< 有关 endpointBehaviors> 元素的详细信息<，请参阅另请参阅中的相应主题。

例如：

<behavior name="sampleBehavior"><callbackTimeouts/></behavior>

类型：字符串默认值：空字符串应用于：WCF-Custom 发送适配器

EstablishSecurityContext

指定安全通道是否建立安全会话。安全会话将在交换应用程序消息之前建立安全上下文令牌 (SCT)。

类型：布尔值默认值：True 应用于：WCF-WSHttp 适配器

FromAddress

指示发送传入 WCF 消息的源终结点地址。属性会自动从传入消息中升级。

类型：字符串适用于：除 WCF-NetMsmq 发送适配器之外的所有 WCF 适配器

标头

指定用于提供除 URI 外的其他寻址信息的终结点引用。使用此属性时，此属性必须将 <headers> 元素作为根元素。所有地址标头都必须放置在 headers> 元素内<。该属性自动从传入消息进行升级。

例如：

<headers>
<Region xmlns="Uri">"String"</Region>
<Member xmlns="Uri">"String"</Member>
</headers>

类型：字符串应用于：所有 WCF 适配器

标识

指定接收位置提供或发送端口预期的服务的标识。可以为 Identity 属性指定的值因安全配置而异。这些设置使客户端能够对服务进行身份验证。在客户端与服务进行握手的过程中，Windows Communication Foundation (WCF) 基础结构将确保服务的标识与客户端的值保持一致。

例如：

<identity>
<userPrincipalName value="username@contoso.com"/>
</identity>

类型：字符串默认值：空字符串应用于：所有 WCF 适配器

InboundBodyLocation

指定传入 WCF 消息的 SOAP Body 元素的数据选择。有关如何使用 InboundBodyLocation 属性的详细信息，请参阅指定 WCF 适配器的消息正文。

类型：字符串默认值：UseBodyElement

适用值包括：

UseBodyElement：使用传入消息的 SOAP Body 元素的内容创建 BizTalk 消息正文部分。如果 Body 元素具有多个子元素，则只有第一个元素成为 BizTalk 消息正文部分。
UseEnvelope：从传入消息的整个 SOAP 信封创建 BizTalk 消息正文部分。
UseBodyPath：使用 InboundBodyPathExpression 属性中的正文路径表达式创建 BizTalk 消息正文部分。针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。此属性仅对要求-响应端口有效。

适用于：除 WCF-NetMsmq 发送之外的所有 WCF 适配器

InboundBodyPathExpression

指定正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。此正文路径表达式是针对传入消息的 SOAP Body 节点的直接子元素计算的。如果此正文路径表达式返回多个节点，则只选择第一个节点作为 BizTalk 消息正文部分。如果将 InboundBodyLocation 属性设置为 UseBodyPath，则需要此属性。有关如何使用 InboundBodyPathExpression 属性的详细信息，请参阅 WCF 适配器属性架构和属性。

类型：字符串默认值：空字符串适用于：除 WCF-NetMsmq 发送适配器之外的所有 WCF 适配器

InboundHeaders

使用 InboundHeaders 属性可访问传入 WCF 消息的 SOAP 标头。 WCF 适配器将入站消息中的所有 SOAP 标头值复制到此属性，其中包括 WCF 基础结构用于诸如 WS-Addressing、WS-Security 和 WS-AtomicTransaction 的自定义 SOAP 标头和标准 SOAP 标头。上下文属性中包含的值是包含 XML 数据的字符串，其中包含<标头>根元素，传入的 SOAP 标头作为 headers> 元素的<子元素复制。有关如何使用 WCF 适配器访问 SOAP 标头的详细信息，请参阅中的 SDK 示例：将自定义 SOAP 标头与 WCF 适配器 https://go.microsoft.com/fwlink/?LinkId=79960配合使用。

类型：字符串适用于：除 WCF-NetMsmq 发送适配器之外的所有 WCF 适配器

InboundNodeEncoding

指定 WCF 接收适配器用于解码 由 InboundBodyPathExpression 中指定的正文路径表达式标识的节点的编码类型。如果将 InboundBodyLocation 属性设置为 UseBodyPath，则需要此属性。

类型：字符串默认值：XML

适用值包括：

Base64：Base64 编码
十六进制：十六进制编码
String：文本编码 - UTF-8
XML：WCF 适配器使用 InboundBodyPathExpression 中的正文路径表达式选择的节点的外部 XML 创建 BizTalk 消息正文。

适用于：除 WCF-NetMsmq 发送适配器之外的所有 WCF 适配器

IsFault

指示是否接收 SOAP 错误消息。属性会自动从传入消息中升级。

注意

IsFault 属性不能用于检查收到的传输错误的消息，例如 HTTP 404 (文件或找不到目录) 错误。

类型：布尔值应用于：除 WCF-NetMsmq 发送适配器之外的所有 WCF 适配器

LeaseTimeout

指定活动的池连接的最大生存期。经过指定的时间后，连接在当前请求得到服务后关闭。

WCF-NetTcp 适配器利用 NetTcpBinding 类与终结点通信。在负载均衡方案中使用 NetTcpBinding 时，请考虑减少默认租约超时。有关使用 NetTcpBinding 时的负载均衡的详细信息，请参阅另请参阅中的相应主题。

类型：字符串默认值：00：05：00 适用范围：WCF-NetTcp 接收适配器

MaxConcurrentCalls

指定针对单个服务实例的并发调用的数目。超出此限制的调用将在队列中排队。将此值设置为 0 等效于将其设置为 Int32.MaxValue。

注意

在 BAM 主导入数据库中无法使用跟踪配置文件跟踪此属性。

类型：整数默认值：200 适用于：除 WCF-Custom 和 WCF-CustomIsolated 适配器之外的所有 WCF 接收适配器

MaxConnections

指定监听程序可以拥有的等待应用程序接受的最大连接数。超出此配额值时，新的传入连接会被丢弃而不是等待接受。

注意

由于这是一个适配器处理程序属性，因此该属性无法在管道组件和业务流程中进行配置。

注意

在 BAM 主导入数据库中无法使用跟踪配置文件跟踪此属性。

类型：整数默认值：10 适用于：WCF-NetNamedPipe 适配器、WCF-NetTcp 适配器

MaxReceivedMessageSize

指定网络上可接收的消息的最大大小（包括标头），以字节为单位。消息的大小受为每条消息分配的内存量的限制。你可以使用此属性来降低受拒绝服务 (DoS) 攻击的可能性。

类型：整数默认值：65536 适用于：

WCF-BasicHttp 适配器
WCF-WSHttp 适配器
WCF-NetTcp 适配器
WCF-NetNamedPipe 适配器
WCF-NetMsmq 接收适配器

MessageClientCredentialType

指定使用基于消息的安全性对客户端执行验证时所用的凭据类型。

适用值因每个 WCF 适配器的不同而异。有关 MessageClientCredentialType 属性的详细信息，请参阅 WCF 适配器中每个 WCF 适配器的操作说明主题。

类型：字符串适用于：

WCF-BasicHttp 适配器
WCF-WSHttp 适配器
WCF-NetTcp 适配器
WCF-NetNamedPipe 适配器

MessageEncoding

指定用于对 SOAP 消息进行编码的编码器。

类型：字符串默认值：文本

适用的值：

文本：使用短信编码器
Mtom：使用消息传输组织机制 1.0 (MTOM) 编码器

适用于：WCF-BasicHttp 适配器、WCF-WSHttp 适配器

MsmqAuthenticationMode

指定如何通过 MSMQ 传输对消息进行验证。

类型：字符串默认值：WindowsDomain 有关 MsmqAuthenticationMode 属性的适用值的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的“WCF-NetMsmq 传输属性”对话框中的“发送、安全性”选项卡中的 MSMQ身份验证模式属性。适用于：WCF-NetMsmq 适配器

MsmqEncryptionAlgorithm

指定在消息队列管理器之间传输消息时，将在网络上使用的消息加密算法。仅当 MsmqProtectionLevel 属性设置为 EncryptAndSign 时，此属性才可用。

类型：字符串默认值： RC4Stream

适用的值为：RC4Stream、AES

适用于：WCF-NetMsmq 适配器

MsmqProtectionLevel

指定消息在 MSMQ 传输一级的保护方式。

类型：字符串默认值： Sign

适用值包括：

无：无保护
签名：对消息进行签名
EncryptAndSign：对消息进行加密和签名。若要使用此保护级别，必须为 MSMQ 启用 Active Directory 集成

适用于：WCF-NetMsmq 适配器

MsmqSecureHashAlgorithm

指定使用哈希算法计算消息摘要。如果 MsmqProtectionLevel 属性设置为 None，则此属性不可用。

类型：字符串默认值： SHA1

适用的值为：MD5、SHA1、SHA25、SHA512

适用于：WCF-NetMsmq 适配器

NegotiateServiceCredential

指定是在带外客户端提供服务凭据，还是通过协商过程从服务将服务凭据提供给客户端。这种协商是正常消息交换的前提。

如果 MessageClientCredentialType 属性等于 None、 Username 或 Certificate，则将此属性设置为 False 意味着服务证书在带外客户端可用，并且客户端需要指定服务证书。此模式可与实现 WS-Trust 和 WS-SecureConversation 的 SOAP 堆栈交互操作。

如果 MessageClientCredentialType 属性设置为 Windows，则将此属性设置为 False 将指定基于 Kerberos 的身份验证。这意味着客户端和服务必须是相同 Kerberos 域的一部分。此模式可与实现 Kerberos 令牌配置文件（如 OASIS WSS TC 中所定义）以及 WS-Trust 和 WS-SecureConversation 的 SOAP 堆栈交互操作。

如果此属性为 True，则会导致 .NET SOAP 协商通过 SOAP 消息通过隧道进行 SPNego 交换。

类型：布尔值默认值：True 适用于：WCF-WSHttp 适配器

OpenTimeout

指定一个时间跨度值来表示为完成信道打开操作提供的时间间隔。

注意

在 BAM 主导入数据库中无法使用跟踪配置文件跟踪此属性。

类型：字符串默认值：00：01：00 适用范围：除 WCF-Custom 和 WCF-CustomIsolated 适配器之外的所有 WCF 适配器

OrderedProcessing

指定是否按顺序处理消息。选择此属性后，当与 BizTalk 消息传送或业务流程发送端口结合使用时，此接收位置将容纳已排序的消息传递，该端口的 “有序传递 ”选项设置为 True。有关 “订购交货 ”选项的详细信息，请参阅另请参阅中的相应主题。

此属性适用于以下情况：

WCF-Custom 适配器：当 BindingType 属性设置为 netMsmqBinding 时
WCF-Custom 适配器：当 BindingType 属性设置为 customBinding 时，并且 BindingConfiguration 属性配置为使用依赖于支持有序传递的传输（如 MSMQ）的自定义通道。
WCF-CustomIsolated 适配器：当 BindingType 属性设置为 customBinding 时，并且 BindingConfiguration 属性配置为使用依赖于支持有序传递的传输的自定义通道。
WCF-NetMsmq 适配器

类型：字符串默认值： False 适用于：

WCF-NetMsmq 接收适配器
WCF-Custom 接收适配器
WCF-CustomIsolated 接收适配器

OutboundBodyLocation

指定传出 WCF 消息的 SOAP Body 元素的数据选择。有关如何使用 OutboundBodyLocation 属性的详细信息，请参阅指定 WCF 适配器的消息正文。

类型：字符串默认值：UseBodyElement

适用值包括：

UseBodyElement：使用 BizTalk 消息正文部件为传出消息创建 SOAP Body 元素的内容
UseTem****plate：使用 OutboundXMLTemplate 属性中提供的模板为传出消息创建 SOAP Body 元素的内容

适用于：除 WCF-NetMsmq 接收适配器之外的所有 WCF 适配器

OutboundCustomHeaders

指定传出消息的自定义 SOAP 标头。使用此属性时，该属性必须将 <headers> 元素作为根元素。所有自定义 SOAP 标头都必须放置在 headers> 元素内<。如果自定义 SOAP 标头值为空字符串，则必须将标头></标头>或<标头>分配给<此属性。有关如何将 SOAP 标头与 WCF 适配器一起使用的详细信息，请参阅中的 SDK 示例将自定义 SOAP 标头与 WCF 适配器 https://go.microsoft.com/fwlink/?LinkId=79960配合使用。

类型：字符串应用于：除 WCF-NetMsmq 接收适配器之外的所有 WCF 适配器

OutboundXmlTemplate

为传出消息的 SOAP Body 元素的内容指定 XML 格式的模板。如果 OutboundBodyLocation 属性设置为 UseTemplate，则需要此属性。有关如何使用 OutboundXMLTemplate 属性的详细信息，请参阅指定 WCF 适配器的消息正文。

类型：字符串默认值：空字符串适用于：除 WCF-NetMsmq 接收适配器之外的所有 WCF 适配器

密码

当 UseSSO 属性设置为 False 时，指定用于对目标服务器进行身份验证的密码。

类型：字符串默认值：空字符串适用于：除 WCF-NetNamedPipe 适配器之外的所有 WCF 发送适配器

PropagateFaultMessage

指定是否路由或挂起出站处理中失败的消息。此属性仅对要求-响应端口有效。

注意

在 BAM 主导入数据库中无法使用跟踪配置文件跟踪此属性。

类型：布尔值默认值： True

适用值包括：

True：将出站处理失败的消息路由到订阅应用程序 (，例如另一个接收端口或业务流程计划)
False：挂起失败的消息并生成否定确认 (NACK)

适用于：除 WCF-NetMsmq 适配器之外的所有 WCF 发送适配器

ProxyAddress

指定代理服务器的地址。根据安全配置使用 https 或 http 方案。此地址后面可跟冒号和端口号。如果 ProxyToUse 属性设置为 UserSpecified (则属性是必需的。例如， http://127.0.0.1:8080)

类型：字符串默认值：空字符串应用于：WCF-BasicHttp 发送适配器、WCF-WSHttp 发送适配器

ProxyPassword

指定用于 ProxyAddress 属性中指定的代理服务器的密码。

类型：字符串默认值：空字符串应用于：WCF-BasicHttp 发送适配器、WCF-WSHttp 发送适配器

ProxyToUse

指定要用于传出 HTTP 通信的代理服务器。

类型：字符串默认值：无

适用值包括：

无：不对此发送端口使用代理服务器
默认值：在托管此发送端口的发送处理程序中使用代理设置
UserSpecified：使用 ProxyAddress 属性中指定的代理服务器

适用于：WCF-BasicHttp 发送适配器、WCF-WSHttp 发送适配器

ProxyUserName

指定用于 ProxyAddress 属性中指定的代理服务器的用户名。如果 ProxyToUse 属性设置为 UserSpecified，则属性是必需的。

有关此属性的详细信息，请参阅如何配置 WCF-WSHttp 发送端口和配置 WCF-BasicHttp 发送端口。

类型：字符串应用于：WCF-BasicHttp 发送适配器、WCF-WSHttp 发送适配器

ReplyToAddress

指示与通过请求响应接收位置接收的传入消息相对应的传出 WCF 消息的回复终结点地址。属性会自动从传入消息中升级。

类型：字符串默认值：空字符串适用于：除 WCF-NetMsmq 适配器之外的所有 WCF 适配器

SecurityMode

指定使用的安全类型。适用值因每个 WCF 适配器的不同而异。有关 SecurityMode 属性的详细信息，请参阅 WCF 适配器中每个 WCF 适配器的操作方法主题。

注意

在 BAM 主导入数据库中无法使用跟踪配置文件跟踪此属性。

类型：字符串适用于：除 WCF-Custom 和 WCF-CustomIsolated 适配器之外的所有 WCF 适配器

SendTimeout

指定一个时间跨度值来表示为完成发送操作提供的时间间隔。此值指定完成整个交互的时间跨度（即使响应方返回一条大消息）。

类型：字符串默认值：00：01：00 适用范围：除 WCF-Custom 和 WCF-CustomIsolated 适配器之外的所有 WCF 适配器

ServiceBehaviorConfiguration

指定一个 XML 字符串，<>其中包含serviceBehaviors> 元素的行为<元素，以配置 WCF 服务的行为设置。有关 serviceBehaviors> 元素的详细信息<，请参阅另请参阅中的相应主题。

例如：

<behavior name="SampleServiceBehavior">
<serviceAuthorization principalPermissionMode="UseAspNetRoles"/>
<serviceCredentials>
<serviceCertificate findValue="539d9ab3089bb6dc187fa7dbb382cf01f8d78f5f" storeLocation="CurrentUser" x509FindType="FindByThumbprint"/>
</serviceCredentials>
<serviceMetadata httpGetEnabled="true"/>
</behavior>

类型：字符串默认值：空字符串应用于：WCF-Custom 接收适配器、WCF-CustomIsolated 适配器

ServiceCertificate

如果此属性用于接收位置，则为接收位置指定 X.509 证书的指纹，客户端利用该指纹验证服务。要用于此属性的证书必须安装到“当前用户”位置的“我的存储”中。

如果此属性用于发送端口，请指定 X.509 证书的指纹，用于验证此发送端口将消息发送到的服务。要用于此属性的证书必须安装到“本地计算机”位置的“其他人员存储中。

类型：字符串默认值：空字符串适用于：

WCF-BasicHttp 适配器
WCF-NetMsmq 适配器
WCF-WSHttp 适配器
WCF-NetTcp 接收适配器

SuspendMessageOnFailure

指定是否将由于接收管道故障或路由故障而导致入站处理失败的请求消息挂起。

类型：布尔值默认值：True 应用于：所有 WCF 接收适配器

TextEncoding

指定在 MessageEncoding 属性设置为 Text 时用于在绑定上发出消息的字符集编码。

注意

在 BAM 主导入数据库中无法使用跟踪配置文件跟踪此属性。

类型：字符串默认值：utf-8

适用值包括：

unicodeFFF：Unicode BigEndian 编码
utf-16：16 位编码
utf-8：8 位编码

适用于：WCF-BasicHttp 适配器、WCF-WSHttp 适配器

TimeToLive

指定一个时间范围，在此范围内消息有效，一旦超出此范围，消息将到期并被置于死信队列。设置此属性是为了确保时间敏感消息在被发送端口处理前不会变得陈旧。队列中在指定的时间间隔内未由此发送端口使用的消息将被认为到期。到期的消息将发送到称为死信队列的特殊队列。死信队列的位置是使用 DeadLetterQueue 属性设置的。

类型：字符串默认值：1.00：00：00 适用于：WCF-NetMsmq 发送适配器

功能

为 WCF 发送端口发送的传出 WCF 消息指定目标终结点地址。

类型：字符串默认值：空字符串适用于：所有 WCF 发送适配器

TransactionProtocol

指定要与此绑定一起使用的事务协议。如果 EnableTransaction 属性设置为 True，则需要此属性。

类型：字符串默认值：OleTransaction

适用的值为：OleTransaction、WS-AtomicTransaction

适用于：WCF-NetNamedPipe 适配器、WCF-NetTcp 适配器

TransportClientCredentialType

指定执行发送端口验证时使用的凭据类型。适用值因每个 WCF 适配器的不同而异。有关 TransportClientCredentialType 属性的详细信息，请参阅 WCF 适配器中每个 WCF 适配器的操作说明主题。

类型：字符串适用于：WCF-Basic 适配器、WCF-NetTcp 适配器 WCF-WSHttp 适配器

TransportProtectionLevel

指定 TCP 传输级别的安全性。消息签名降低了在消息传输过程中第三方对消息进行篡改的风险。加密为传输过程提供了数据级保密功能。

类型：字符串默认值： EncryptAndSign

适用值包括：

无：无保护
签名：对消息进行签名
EncryptAndSign：对消息进行加密和签名

适用于：WCF-NetTcp 适配器、WCF-NetNamedPipe 适配器

UserName

当 UseSSO 属性设置为 False 时，指定用于向目标服务器进行身份验证的用户名。不必采用“域\用户”格式设置此属性。

类型：字符串默认值：空字符串适用于：除 WCF-NetNamedPipe 适配器之外的所有 WCF 发送适配器

UseSourceJournal

指定是否应将此发送端口处理的消息副本存储在源日记队列中。

类型：布尔值默认值：False 适用于：WCF-NetMsmq 发送适配器

UseSSO

指定是否使用单一登录检索客户端凭据，以便在目标服务器上进行验证。

注意无法使用跟踪配置文件在 BAM 主导入数据库中跟踪此属性。

类型：布尔值默认值：False 应用于：除 WCF-NetNamedPipe 适配器之外的所有 WCF 发送适配器

ReferencedBindings

为 wsFederationHttpBinding 和 customBinding 指定由颁发者>元素的<bindingConfiguration 属性引用的绑定配置，这指示颁发安全令牌的安全令牌服务 (STS) 。有关颁发者<>元素的详细信息，请参阅中的https://go.microsoft.com/fwlink/?LinkId=83476主题“<issuer>”。

可以通过 WCF-Custom 和 WCF-CustomIsolated 适配器的 BindingConfiguration 属性配置绑定信息，包括 wsFederationHttpBinding 和 customBinding 的颁发者>元素。< 此属性的所有引用绑定配置都必须以绑定>元素的形式<放置。

注意

issuer> 元素的<bindingConfiguration 属性必须引用此属性中的有效绑定名称。

注意

如果引用链不生成循环依赖项，则引用的绑定配置中的 issuer> 元素也可以引用此属性中的不同绑定配置。<

例如：

WCF.BindingConfiguration = @"<wsFederationHttpBinding>
<binding name=""sampleBinding"">
<security mode=""Message"">
<message issuedKeyType=""AsymmetricKey"">
<issuer address=""http://www.contoso.com/samplests"" binding=""wsFederationHttpBinding"" bindingConfiguration=""**contosoSTSBinding**""/>
</message>
</security>
</binding>
</wsFederationHttpBinding>";
WCF.ReferencedBinding =@"<bindings>
<wsFederationHttpBinding>
<binding name=""**contosoSTSBinding**"">
<security mode=""Message"">
<message negotiateServiceCredential=""false"">
<issuer address=""https://northwind.com/samplests"" bindingConfiguration=""**northwindBinding**"" binding=""wsHttpBinding"">
</issuer>
</message>
</security>
</binding>
</wsFederationHttpBinding>
<wsHttpBinding>
<binding name=""**northwindBinding**"">
<security mode=""Message"">
<message clientCredentialType=""Certificate""/>
</security>
</binding>
</wsHttpBinding>
</bindings>"

注意

ReferencedBinding 属性不得包含 BindingConfiguration 属性中使用的绑定配置。

类型：字符串默认值：空字符串应用于：WCF-Custom 适配器、WCF-CustomIsolated 适配器

另请参阅

wcf 适配器 <的><endpointBehaviors><绑定><行为><serviceBehaviors>有序传递消息负载均衡

通过

WCF 适配器属性架构和属性

提升的属性

操作

AffiliateApplicationName

AlgorithmSuite

BindingConfiguration

BindingType

ClientCertificate

CloseTimeout

CustomDeadLetterQueue

DeadLetterQueue

DisableLocationOnFailure

EnableTransaction

EndpointBehaviorConfiguration

EstablishSecurityContext

FromAddress

标头

标识

InboundBodyLocation

InboundBodyPathExpression

InboundHeaders

InboundNodeEncoding

IsFault

LeaseTimeout

MaxConcurrentCalls

MaxConnections

MaxReceivedMessageSize

MessageClientCredentialType

MessageEncoding

MsmqAuthenticationMode

MsmqEncryptionAlgorithm

MsmqProtectionLevel

MsmqSecureHashAlgorithm

NegotiateServiceCredential

OpenTimeout

OrderedProcessing

OutboundBodyLocation

OutboundCustomHeaders

OutboundXmlTemplate

密码

PropagateFaultMessage

ProxyAddress

ProxyPassword

ProxyToUse

ProxyUserName

ReplyToAddress

SecurityMode

SendTimeout

ServiceBehaviorConfiguration

ServiceCertificate

SuspendMessageOnFailure

TextEncoding

TimeToLive

功能

TransactionProtocol

TransportClientCredentialType

TransportProtectionLevel

UserName

UseSourceJournal

UseSSO

ReferencedBindings

另请参阅

反馈

其他资源