<msmqTransport>

Makale
06/08/2023

Bir kanalın, özel bağlamaya eklendiğinde MSMQ aktarımındaki iletileri aktarmasına neden olur.

<Yapılandırma>
  <system.serviceModel>
    <Bağlama>
      <Custombinding>
        <Bağlama>
          <msmqTransport>

Syntax

<msmqTransport customDeadLetterQueue="Uri"
               deadLetterQueue="Custom/None/System"
               durable="Boolean"
               exactlyOnce="Boolean"
               manualAddressing="Boolean"
               maxBufferPoolSize="Integer"
               maxImmediateRetries="Integer"
               maxPoolSize="Integer"
               maxReceivedMessageSize="Integer"
               maxRetryCycles="Integer"
               queueTransferProtocol="Native/Srmp/SrmpSecure"
               rejectAfterLastRetry="Boolean"
               retryCycleDelay="TimeSpan"
               timeToLive="TimeSpan"
               useActiveDirectory="Boolean"
               useSourceJournal="Boolean"
               useMsmqTracing="Boolean"
               ...>
  <msmqTransportSecurity>
  </msmqTransportSecurity>
</msmqTransport>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Açıklama
customDeadLetterQueue	Süresi dolmuş veya uygulamaya teslim edilemeyen iletilerin aktarıldığı, uygulama başına teslim edilemeyen ileti kuyruğunun konumunu gösteren bir URI. ExactlyOnce güvencesi gerektiren iletiler için (yani, `exactlyOnce` olarak `true`ayarlanır), bu öznitelik varsayılan olarak MSMQ'daki sistem genelinde işlemsel teslim edilemeyen ileti kuyruğuna ayarlanır. Güvence gerektirmeyen iletiler için (yani, `exactlyOnce` olarak ayarlanır `false`), bu öznitelik varsayılan olarak `null`kullanılır. Değerin net.msmq düzenini kullanması gerekir. Varsayılan değer: `null`. veya `System`olarak ayarlanırsa `NonedeadLetterQueue`, bu öznitelik olarak `null`ayarlanmalıdır. Bu öznitelik değilse `null`, `deadLetterQueue` olarak ayarlanmalıdır `Custom`.
Deadletterqueue	Kullanılacak teslim edilemeyen ileti kuyruğunun türünü belirtir. Geçerli değerler şunlardır: - Özel: Özel yeniden kullanıma alma kuyruğu. - Hiçbiri: Artık kuyruk kullanılmaz. - Sistem: Sistem yeniden kullanımdan kaldırılma kuyruğu kullanın. Bu öznitelik DeadLetterQueue türündedir.
Dayanıklı	Bu bağlama tarafından işlenen iletilerin dayanıklı mı yoksa geçici mi olduğunu belirten bir Boole değeri. Varsayılan değer: `true`. Dayanıklı ileti kuyruk yöneticisinin kilitlenmesine rağmen kalıcı bir iletiyle devam eder, ancak geçici bir ileti kilitlenmez. Geçici iletiler, uygulamalar daha düşük gecikme süresi gerektirdiğinde ve zaman zaman kaybolan iletileri tolere ettiğinde yararlıdır. olarak ayarlanırsa `exactlyOncetrue`, iletiler dayanıklı olmalıdır.
Exactlyonce	Bu bağlama tarafından işlenen iletilerin tam olarak bir kez alınıp alınmayacağını belirten bir Boole değeri. Varsayılan değer: `true`. İleti, güvenceli veya güvencesiz olarak gönderilebilir. Güvence, uygulamanın gönderilen bir iletinin alıcı ileti kuyruğuna ulaştığından emin olmasını sağlar veya ulaşmadıysa, uygulama teslim edilemeyen ileti kuyruğunu okuyarak bunu belirleyebilir. `exactlyOnce`olarak ayarlandığında `true`, MSMQ'nin gönderilen iletinin alıcı ileti kuyruğuna bir kez ve yalnızca bir kez teslim edilmesini sağlayacağını belirtir ve teslim başarısız olursa ileti teslim edilemeyen ileti kuyruğuna gönderilir. olarak ayarlanmış `true` olarak `exactlyOnce` gönderilen iletilerin yalnızca işlem kuyruğuna gönderilmesi gerekir.
Manualaddressing	Kullanıcının ileti adresleme denetimini almasını sağlayan boole değeri. Bu özellik genellikle, uygulamanın ileti göndermek için çeşitli hedeflerden hangisini belirlediği yönlendirici senaryolarında kullanılır. olarak ayarlandığında `true`, kanal iletinin zaten ele alındığını varsayar ve iletiye ek bilgi eklemez. Kullanıcı daha sonra her iletiyi tek tek ele alabilir. olarak ayarlandığında `false`, varsayılan Windows Communication Foundation (WCF) adresleme mekanizması tüm iletiler için adresleri otomatik olarak oluşturur. Varsayılan değer: `false`.
maxBufferPoolSize	Arabellek havuzunun en büyük boyutunu belirten pozitif bir tamsayı. Varsayılan değer 524288. WCF'nin birçok bölümü arabellek kullanır. Arabelleklerin her kullanıldığında oluşturulması ve yok edilmesi pahalıdır ve arabellekler için atık toplama da pahalıdır. Arabellek havuzları ile havuzdan bir arabellek alabilir, kullanabilir ve işiniz bittiğinde havuza döndürebilirsiniz. Bu nedenle arabellek oluşturma ve yok etme ek yükünden kaçınılır.
maxImmediateRetries	Uygulama kuyruğundan okunan bir iletide en fazla yeniden deneme denemesi sayısını belirten tamsayı. Varsayılan değer 5’tir. İleti için en fazla yeniden deneme sayısı denenirse ve ileti uygulama tarafından tüketilmiyorsa, ileti daha sonraki bir noktada yeniden deneme için bir yeniden deneme kuyruğuna gönderilir. Yeniden deneme döngüsü belirtilmezse, iletiler zehirli ileti kuyruğuna gönderilir veya gönderene geri olumsuz bir onay gönderilir.
Maxpoolsize	Havuzun en büyük boyutunu belirten pozitif bir tamsayı. Varsayılan değer 524288.
maxReceivedMessageSize	Üst bilgiler de dahil olmak üzere bayt cinsinden en büyük ileti boyutunu belirten pozitif bir tamsayı. İleti alıcı için çok büyük olduğunda iletinin göndereni SOAP hatası alır. Alıcı iletiyi bırakır ve izleme günlüğünde olayın bir girişini oluşturur. Varsayılan değer 65536'dır.
maxRetryCycles	İletilerin alıcı uygulamaya teslimini denemek için en fazla yeniden deneme döngüsü sayısını belirten bir tamsayı. Varsayılan değer: MaxValue. Tek bir yeniden deneme döngüsü, bir uygulamaya belirli sayıda ileti teslim etmeye çalışır. Yapılan deneme sayısı özniteliği tarafından `maxImmediateRetries` ayarlanır. Teslim denemeleri tükendikten sonra uygulama iletiyi kullanamazsa, ileti yeniden deneme kuyruğuna gönderilir. Sonraki yeniden deneme döngüleri, özniteliği tarafından belirtilen bir gecikmeden sonra uygulamaya teslimi yeniden denemek için yeniden deneme kuyruğundan uygulama kuyruğuna döndürülen iletiden `retryCycleDelay` oluşur. özniteliği, `maxRetryCycles` uygulamanın iletiyi teslim etmek için kullandığı yeniden deneme döngülerinin sayısını belirtir.
Queuetransferprotocol	Bu bağlamanın kullandığı kuyruğa alınmış iletişim kanalı aktarımını belirtir. Geçerli değerler şunlardır: - Yerel: Yerel MSMQ protokollerini kullanın. - Srmp: Soap Reliable Messaging Protocol (SRMP) kullanın. - SrmpSecure: Soap Reliable Messaging Protocol Secure (SRMPS) aktarımını kullanın. Bu öznitelik türündedir QueueTransferProtocol. MSMQ, SOAP Reliable Messaging Protokolü kullanırken Active Directory adreslemesi desteklemediğinden, olarak ayarlandığında bu özniteliği Srmp veya Srmps `useActiveDirectory` olarak `true`ayarlamamalısınız.
rejectAfterLastRetry	Yeniden deneme sayısı üst sınırı denendikten sonra teslimi başarısız olan bir ileti için gerçekleştirilecek eylemi belirten Boole değeri. `true` , gönderene negatif bir bildirim döndürüldüğü ve iletinin bırakıldığını gösterir; `false` , iletinin zehirli ileti kuyruğuna gönderildiği anlamına gelir. Varsayılan değer: `false`. değer ise `false`, alıcı uygulama zehirli iletileri (yani teslimi başarısız olan iletileri) işlemek için zehirli ileti kuyruğunu okuyabilir. MSMQ 3.0, gönderene olumsuz bir bildirim döndürmeyi desteklemez, bu nedenle bu öznitelik MSMQ 3.0'da yoksayılır.
retryCycleDelay	Hemen TimeSpan teslim edilemeyen bir ileti teslim edilmeye çalışıldığında yeniden deneme döngüleri arasındaki gecikme süresini belirten bir. Varsayılan değer 00:10:00'dır. Tek bir yeniden deneme döngüsü, alıcı uygulamaya belirtilen sayıda ileti teslim etmeye çalışır. Yapılan deneme sayısı özniteliği tarafından `maxImmediateRetries` belirtilir. Uygulama belirtilen sayıda anında yeniden denemeden sonra iletiyi tüketemezse, ileti bir yeniden deneme kuyruğuna gönderilir. Sonraki yeniden deneme döngüleri, özniteliği tarafından belirtilen bir gecikmeden sonra uygulamaya teslimi yeniden denemek için yeniden deneme kuyruğundan uygulama kuyruğuna döndürülen iletiden `retryCycleDelay` oluşur. Yeniden deneme döngülerinin sayısı özniteliği tarafından `maxRetryCycles` belirtilir.
timeToLive	TimeSpan İletilerin süresi dolmadan ve teslim edilemeyen ileti kuyruğuna konulmadan önce ne kadar süre geçerli olduğunu belirten bir. Varsayılan değer 1.00:00:00'dır ve bu da 1 gün anlamına gelir. Bu öznitelik, zamana duyarlı iletilerin alıcı uygulamalar tarafından işlenmeden önce eskimemesini sağlamak için ayarlanır. Belirtilen zaman aralığı içinde alıcı uygulama tarafından kullanılmayan bir kuyruktaki iletinin süresinin dolduğu söylenir. Süresi dolan iletiler, teslim edilemeyen ileti kuyruğu olarak adlandırılan özel kuyruğa gönderilir. Teslim edilemeyen ileti kuyruğunun konumu, güvencelere bağlı olarak özniteliğiyle veya uygun varsayılan değerle `customDeadLetterQueue` ayarlanır.
UseActiveDirectory	Kuyruk adreslerinin Active Directory kullanılarak dönüştürülip dönüştürülmeyeceğini belirten bir Boole değeri. MSMQ kuyruk adresleri yol adlarından veya doğrudan biçim adlarından oluşabilir. Msmq, doğrudan biçim adıyla BILGISAYAR adını DNS, NetBIOS veya IP kullanarak çözümler. Bir yol adıyla MSMQ, Active Directory kullanarak bilgisayar adını çözümler. Varsayılan olarak, Windows Communication Framework (WCF) kuyruğa alınmış aktarım, bir ileti kuyruğunun URI'sini doğrudan biçim adına dönüştürür. Bir uygulama, bu özniteliği olarak `true`ayarlayarak, kuyruğa alınan aktarımın BILGISAYAR adını DNS, NetBIOS veya IP yerine Active Directory kullanarak çözümlemesi gerektiğini belirtebilir.
useMsmqTracing	Bu bağlama tarafından işlenen iletilerin izlenip izlenmeyeceğini belirten bir Boole değeri. Varsayılan değer: `false`. İzleme etkinleştirildiğinde, ileti bir Message Queuing bilgisayarına her ayrıldığında veya ulaştığında rapor iletileri oluşturulur ve rapor kuyruğuna gönderilir.
useSourceJournal	Bu bağlama tarafından işlenen iletilerin kopyalarının kaynak günlük kuyruğunda depolanıp depolanmayacağını belirten bir Boole değeri. Varsayılan değer: `false`. Bilgisayarın giden kuyruğundan ayrılan iletilerin kaydını tutmak isteyen kuyruğa alınmış uygulamalar, iletileri günlük kuyruğuna kopyalayabilir. Bir ileti giden kuyruğundan ayrıldığında ve iletinin hedef bilgisayara alındığına dair bir bildirim alındığında, iletinin bir kopyası gönderen bilgisayarın sistem günlüğü kuyruğunda tutulur.

Alt Öğeler

Öğe	Açıklama
<msmqTransportSecurity>	Bu bağlama için aktarım güvenlik ayarlarını belirtir. Bu öğe türündedir MsmqTransportSecurityElement.

Üst Öğeler

Öğe	Açıklama
<Bağlama>	Özel bağlamanın tüm bağlama özelliklerini tanımlar.

Açıklamalar

msmqTransport öğesi, kullanıcının kuyruğa alınan iletişim kanalının özelliklerini ayarlamasını sağlar. Kuyruğa alınan iletişim kanalı, aktarım için Message Queuing'i kullanır.

Bu bağlama öğesi, Message Queuing standart bağlaması (netMsmqBinding tarafından kullanılan varsayılan bağlama öğesidir.

Aracılığıyla paylaş