共用方式為

WCF 配接器屬性結構描述和屬性

  • 發行項

閱讀 WCF 配接器屬性架構中的升級屬性。 WCF 配接器會為您可以在應用程式中使用的屬性指派值。 WCF 配接器也提供了一種將自訂屬性寫入但不升級至 BizTalk 訊息內容的機制，以及一種將自訂屬性升級至 BizTalk 訊息內容的機制。 如需詳細資訊，請參閱 具有已發佈 WCF 服務的 SOAP 標頭。

命名空間︰http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties

動作

指定傳出訊息的 SOAPAction 標頭欄位。 您可以透過兩種不同的方式指定此值：單一動作格式和動作對應格式。 如果您以單一動作格式設定此屬性，例如， http://contoso.com/Svc/Op1 傳出訊息的 SOAPAction 標頭一律會設定為此屬性中指定的值。

如果您以動作對應格式設定此屬性，則傳出 SOAPAction 標頭是由 BTS 決定。作業 內容屬性。 例如，如果此屬性設定為下列 XML 格式和BTS。Operation屬性設定為 Op1，WCF 傳送配接器會針對傳出SOAPAction標頭使用 http://contoso.com/Svc/Op1 。

<BtsActionMapping>
<Operation Name="Op1" Action="http://contoso.com/Svc/Op1">
<Operation Name="Op2" Action="http://contoso.com/Svc/Op2">
</BtsActionMapping>

如果傳出訊息來自協調流程埠，協調流程實例就會動態設定 BTS。具有 埠作業名稱的 Operation 屬性。 如果傳出訊息是以內容為基礎的路由傳送，您可以設定 BTS。 管線元件中的 Operation 屬性。 這個屬性會以單一動作格式自動從內送訊息升級。

類型：字串預設值：空字串適用于：所有 WCF 傳送配接器

AffiliateApplicationName

指定要針對企業單一登入 (SSO) 使用的分支機構應用程式。 如果 UseSSO 屬性設定為 True，則需要這個屬性。

類型：字串預設值：空字串適用于：除了 WCF-NetNamedPipe 配接器 以外的 所有 WCF 傳送配接器

AlgorithmSuite

指定訊息加密和 Key Wrap 演算法。 這些演算法會對應到安全性原則語言 (WS-SecurityPolicy) 規格中所指定的演算法。

如需AlgorithmSuite屬性適用值的詳細資訊，請參閱UI 指引和開發人員 API 命名空間參考中的WCF-NetTcp 傳輸屬性對話方塊、傳送、安全性索引標籤中的Algorithm suite屬性。

類型：字串預設值： 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 自訂傳輸屬性對話方塊、傳送、系結索引標籤中的 Binding Type屬性。

類型：字串預設值：空字串適用于：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 以外的 所有 WCF 配接器

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>
<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屬性適用值的詳細資訊，請參閱WCF-NetMsmq 傳輸屬性對話方塊、傳送、安全性索引標籤中的 UI指引和開發人員 API 命名空間參考中的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 標頭值是空字串，您必須將標頭>< /標頭> 或 <標頭> 指派 < 給這個屬性。 如需如何搭配 WCF 配接器使用 SOAP 標頭的詳細資訊，請參閱 SDK https://go.microsoft.com/fwlink/?LinkId=79960 範例：搭配 WCF 配接器使用自訂 SOAP 標頭。

類型：字串適用于：除了 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

指定 Proxy 伺服器的位址。 視安全性組態而定，請使用 HTTPs 或 HTTP 配置。 這個位址後面可以加上冒號和連接埠編號， 如果 ProxyToUse 屬性設定為 UserSpecified (則為必要屬性，例如， http://127.0.0.1:8080)

類型：字串預設值：空字串適用于：WCF-BasicHttp 傳送配接器，WCF-WSHttp 傳送配接器

ProxyPassword

指定要用於 ProxyAddress 屬性中所指定 Proxy 伺服器的密碼。

類型：字串預設值：空字串適用于：WCF-BasicHttp 傳送配接器，WCF-WSHttp 傳送配接器

ProxyToUse

指定要針對外寄 HTTP 流量使用哪一個 Proxy 伺服器。

類型：字串預設值： 無

適用值為：

  • 無：請勿針對此傳送埠使用 Proxy 伺服器
  • 預設值：在裝載此傳送埠的傳送處理常式中使用 Proxy 設定
  • UserSpecified：使用 ProxyAddress 屬性中指定的 Proxy 伺服器

適用于：WCF-BasicHttp 傳送配接器，WCF-WSHttp 傳送配接器

ProxyUserName

指定要用於 ProxyAddress 屬性中所指定 Proxy 伺服器的使用者名稱。 如果 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

使用serviceBehaviors > 元素的行為專案 < 來指定 XML 字串，以設定 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 配接器

使用者名稱

當 UseSSO 屬性設定為 False時，指定要用於向目的地伺服器進行驗證的使用者名稱。 您不需要對此屬性使用 domain\user 格式。

類型：字串預設值：空字串適用于：除了 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 中的「 < 簽發者 > 」。

系結資訊包括wsFederationHttpBinding和customBinding的簽發者 > 元素，可以透過 WCF-Custom 和 WCF-CustomIsolated 配接器的 BindingConfiguration 屬性來設定。 < 此屬性的所有參考系結組態都必須以綁定 > 項的形式 <放置。

注意

簽發者 > 專案的 bindingConfiguration 屬性 <必須參考這個屬性中的有效系結名稱。

注意

如果這個參考鏈結鏈結沒有建立迴圈相依性，則參考系結組態中的簽發者 > 元素也可以參考這個屬性中的不同系結組態。 <

範例：

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 配接器

另請參閱

EndpointBehaviors <><> 系結服務的 WCF 配接器行為 ><>< 已排序訊息 < 負載平衡傳遞 >