<netMsmqBinding>

  • 發行項

定義適合跨電腦通訊的佇列繫結。

<configuration>
  <system.serviceModel>
    <bindings>
      <netMsmqBinding>

Syntax

<netMsmqBinding>
  <binding closeTimeout="TimeSpan"
           customDeadLetterQueue="Uri"
           deadLetterQueue="Uri"
           durable="Boolean"
           exactlyOnce="Boolean"
           maxBufferPoolSize="Integer"
           maxReceivedMessageSize="Integer"
           maxRetryCycles="Integer"
           name="String"
           openTimeout="TimeSpan"
           poisonMessageHandling="Disabled/EnabledIfSupported"
           queueTransferProtocol="Native/Srmp/SrmpSecure"
           receiveErrorHandling="Drop/Fault/Move/Reject"
           receiveTimeout="TimeSpan"
           receiveRetryCount="Integer"
           rejectAfterLastRetry="Boolean"
           retryCycleDelay="TimeSpan"
           sendTimeout="TimeSpan"
           timeToLive="TimeSpan"
           useActiveDirectory="Boolean"
           useMsmqTracing="Boolean"
           useSourceJournal="Boolean">
    <security>
      <message algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
               clientCredentialType="None/Windows/UserName/Certificate/InfoCard" />
      <transport msmqAuthenticationMode="None/WindowsDomain/Certificate"
                 msmqEncryptionAlgorithm="RC4Stream/AES"
                 msmqProtectionLevel="None/Sign/EncryptAndSign"
                 msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</netMsmqBinding>

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
closeTimeout TimeSpan 值，指定提供用來讓關閉作業完成的時間間隔。 這個值應該大於或等於 Zero。 預設為 00:01:00。
customDeadLetterQueue URI，其中包含每個應用程式寄不出的信件佇列的位置，所有已過期、無法傳輸或傳遞的訊息都會放到該佇列中。

寄不出的信件佇列是傳送應用程式佇列管理員上的佇列，用於無法傳遞的過期訊息。

由 CustomDeadLetterQueue 指定的 URI 必須使用 net.msmq 配置。
deadLetterQueue 指定要使用何種寄不出信件佇列類型的 DeadLetterQueue 值 (如果有的話)。

無法傳遞至應用程式的訊息將會被傳輸至寄不出的信件佇列。

對於需要 exactlyOnce 保證的訊息 (也就是 exactlyOnce 屬性設定為 true)，這個屬性預設為 MSMQ 中的整個系統異動式寄不出信件佇列。

對於不需要保證的訊息，這個屬性預設為 null。
durable 布林值，指出佇列中的訊息為永久性 (Durable) 或變動性 (Volatile)。 永久性的訊息不受佇列管理員毀損的影響，但變動性訊息會受到影響。 如果應用程式需要較短的延遲時間，並可以容許訊息偶爾遺失，變動性訊息就很有用。 如果 exactlyOnce 屬性設定為 true，則訊息必須為永久性。 預設值為 true。
exactlyOnce 布林值，指出此繫結所處理的每個訊息是否只傳遞一次。 接著會通知傳送者傳遞失敗。 durable 為 false 時，會忽略這個屬性，並傳輸訊息，但不具傳遞保證。 預設為 true。 如需詳細資訊，請參閱ExactlyOnce。
maxBufferPoolSize 指定此繫結之緩衝區集區大小上限的整數。 預設值為 8。
maxReceivedMessageSize 正整數，定義此繫結可以處理的訊息大小上限 (以位元組為單位，包括標頭)。 超出此限制之訊息的寄件者將會收到 SOAP 錯誤。 收件者會捨棄訊息，然後在追蹤記錄檔中建立此事件的項目。 預設值為 65536。 這項關於訊息大小的限制是為了避免受到阻絕服務 (DoS) 攻擊。
maxRetryCycles 整數，指出有害訊息偵測功能使用的重試循環次數。 當訊息無法在循環的傳遞嘗試中成功傳遞，便成為有害訊息。 預設值為 3。 如需詳細資訊，請參閱MaxRetryCycles。
name 必要屬性。 包含繫結之組態名稱的字串。 這個值應該是唯一的，因為它會當做繫結的識別使用。 從 .NET Framework 4 開始，不需要有名稱的系結和行為。 如需預設設定、無名稱繫結與行為的詳細資訊，請參閱簡化的設定 (機器翻譯) 與 WCF 服務的簡化設定 (機器翻譯)。
openTimeout TimeSpan 值，指定提供用來讓開啟作業完成的時間間隔。 這個值應該大於或等於 Zero。 預設為 00:01:00。
QueueTransferProtocol 有效的 QueueTransferProtocol 值，指定此繫結所使用的佇列通訊通道傳輸。 當使用 SOAP Reliable Messaging Protocol 時，MSMQ 不支援 Active Directory 定址。 因此，當 useActiveDirectory 屬性設定為 true 時，您不應將這個屬性設定為 Srmp 或 Srmps。
receiveErrorHandling ReceiveErrorHandling 值，指定如何處理有害和不可分派的訊息。
receiveRetryCount 整數，指定佇列管理員在傳送訊息至重試佇列之前，應嘗試傳送的次數上限。
receiveTimeout TimeSpan 值，指定接收作業完成其作業之時間間隔。 這個值應該大於或等於 Zero。 預設為 00:10:00。
retryCycleDelay TimeSpan 值，指定嘗試傳遞無法立即傳遞之訊息時，重試循環之間的時間延遲。 該值只定義最小等待時間，因為實際的等待時間會更長。 預設值為 00:10:00。 如需詳細資訊，請參閱RetryCycleDelay。
sendTimeout TimeSpan 值，指定提供用來讓傳送作業完成的時間間隔。 這個值應該大於或等於 Zero。 預設為 00:01:00。
timeToLive TimeSpan 值，指定訊息在到期並置入寄不出的信件佇列之前，訊息仍保持有效的時間。 預設為 1.00:00:00。

設定這個屬性可確保有時效的訊息在由接收應用程式處理之前不會變成過時。 佇列中未由接收應用程式於指定的時間間隔內使用的訊息，即稱為過期訊息。 過期訊息會傳送至特別的佇列，稱為寄不出的信件佇列。 寄不出的信件佇列的位置是使用 DeadLetterQueue 屬性設定，或根據保證設定為適當的預設值。
usingActiveDirectory 布林值，指定是否應該使用 Active Directory 來轉換佇列位址。

MSMQ 佇列位址可以由路徑名稱或直接格式名稱組成。 如為直接格式名稱，MSMQ 會使用 DNS、NetBIOS 或 IP 解析電腦名稱。 如為路徑名稱，MSMQ 會使用 Active Directory 解析電腦名稱。

根據預設，Windows Communication Foundation (WCF) 佇列傳輸會將訊息佇列的 URI 轉換為直接格式名稱。 藉由將 UseActiveDirectory 屬性設定為 true，應用程式可以指定佇列傳輸應使用 Active Directory 來解析電腦名稱，而非使用 DNS、NetBIOS 或 IP 來解析。
useMsmqTracing 布林值，指定是否應追蹤由此繫結處理的訊息。 預設值為 false。 如果啟用追蹤，每當訊息離開或到達訊息佇列電腦時，都會建立報告訊息並傳送至報告佇列。
useSourceJournal 布林值，指定是否要將此繫結處理之訊息的複本儲存在來源日誌。 預設值為 false。

有些佇列應用程式要記錄已離開電腦輸出佇列的訊息，這些程式可以將訊息複製到日誌佇列。 只要訊息一離開輸出佇列，而且收到目的端電腦已收到訊息的認可，訊息的複本就會保留在傳送端電腦的系統日誌佇列中。

子元素

元素 描述
<readerQuotas> 定義 SOAP 訊息複雜度的條件約束，而這些條件約束可由以此繫結所設定的端點處理。 此項目的型別為 XmlDictionaryReaderQuotasElement。
<security> 定義繫結的安全性設定。 此項目的型別為 NetMsmqSecurityElement。

父項目

元素 描述
<bindings> 這個項目會保存標準和自訂繫結的集合。

備註

netMsmqBinding 繫結利用 Microsoft Message Queuing (MSMQ) 做為傳輸來提供對於佇列的支援，並可支援結合鬆散的應用程式、失敗隔離、負載撫平和中斷連接作業。 如需這些功能的討論，請參閱 WCF 中的佇列。

範例

<configuration>
  <system.ServiceModel>
    <bindings>
      <netMsmqBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 deadLetterQueue="net.msmq://localhost/blah"
                 durable="true"
                 exactlyOnce="true"
                 maxReceivedMessageSize="1000"
                 maxRetries="11"
                 maxRetryCycles="12"
                 poisonMessageHandling="Disabled"
                 rejectAfterLastRetry="false"
                 retryCycleDelay="00:05:55"
                 timeToLive="00:11:11"
                 sourceJournal="true"
                 useMsmqTracing="true"
                 useActiveDirectory="true">
          <security>
            <message clientCredentialType="Windows" />
          </security>
        </binding>
      </netMsmqBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

另請參閱