Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Definuje vazbu, která poskytuje podporu řízení front směrováním zpráv prostřednictvím MSMQ.
<configuration>
<system.serviceModel>
<bindings>
<customBinding>
<binding>
<msmqIntegrationBinding>
Syntaxe
<msmqIntegrationBinding>
<binding closeTimeout="TimeSpan"
customDeadLetterQueue="Uri"
deadLetterQueue="Uri"
durable="Boolean"
exactlyOnce="Boolean"
maxReceivedMessageSize="Integer"
maxRetryCycles="Integer"
name="String"
openTimeout="TimeSpan"
receiveContextEnabled="Boolean"
receiveErrorHandling="Drop/Fault/Move/Reject"
receiveTimeout="TimeSpan"
receiveRetryCount="Integer"
retryCycleDelay="TimeSpan"
sendTimeout="TimeSpan"
serializationFormat="XML/Binary/ActiveX/ByteArray/Stream"
timeToLive="TimeSpan"
useMsmqTracing="Boolean"
useSourceJournal="Boolean">
</binding>
</msmqIntegrationBinding>
Atributy a prvky
Následující části popisují atributy, podřízené prvky a nadřazené prvky.
Attributes
| Vlastnost | Description |
|---|---|
| closeTimeout | Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace uzavření. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00. |
| customDeadLetterQueue | Identifikátor URI, který obsahuje umístění fronty nedoručených zpráv pro jednotlivé aplikace, kde jsou umístěny zprávy s vypršenou platností nebo neúspěšným přenosem nebo doručením. Fronta nedoručených zpráv je fronta ve správci fronty odesílající aplikace pro zprávy, jejichž platnost vypršela. Identifikátor URI, který je určen CustomDeadLetterQueue pomocí schématu net.msmq. |
| Deadletterqueue | Hodnota DeadLetterQueueurčující, jaký typ fronty nedoručených zpráv se má použít, pokud existuje Fronta nedoručených zpráv je umístění, které se nepodařilo doručit do aplikace. Pro zprávy, které vyžadují přesněOnce assurance (tj exactlyOnce . atribut je nastaven na true), tento atribut je výchozí pro frontu transakčních nedoručených zpráv v systému v MSMQ.Pro zprávy, které nevyžadují žádné záruky null, tento atribut výchozí hodnota . |
| Trvanlivé | Logická hodnota, která označuje, jestli je zpráva v frontě odolná nebo nestálá. Odolná zpráva přežije chybu správce fronty, zatímco nestálá zpráva ne. Nestálé zprávy jsou užitečné, když aplikace vyžadují nižší latenci a mohou tolerovat občasné ztracené zprávy.
exactlyOnce Pokud je atribut nastaven na true, zprávy musí být trvalé. Výchozí hodnota je true. |
| Exactlyonce | Logická hodnota, která označuje, jestli se každá zpráva doručí jenom jednou. Odesílatel pak bude upozorněn na selhání doručení. Pokud durable ano false, tento atribut se ignoruje a zprávy se přenesou bez záruky doručení. Výchozí hodnota je true. Další informace najdete v tématu ExactlyOnce. |
| maxReceivedMessageSize | Kladné celé číslo, které definuje maximální velikost zprávy v bajtech včetně hlaviček, které jsou zpracovány touto vazbou. Odesílatel zprávy překračující tento limit obdrží chybu SOAP. Příjemce zprávu zahodí a vytvoří záznam události v protokolu trasování. Výchozí hodnota je 65536. Tato mez velikosti zprávy je určena k omezení vystavení útokům DoS (DoS). |
| maxRetryCycles | Celé číslo, které označuje počet cyklů opakování používaných funkcí detekce jed-zpráva. Zpráva se stane otrávenou zprávou, když selže všechny pokusy o doručení všech cyklů. Výchozí volba je 2. Další informace najdete v tématu MaxRetryCycles. |
| název | Řetězec, který obsahuje název konfigurace vazby. Tato hodnota by měla být jedinečná, protože se používá jako identifikace vazby. Počínaje rozhraním .NET Framework 4 není nutné, aby vazby a chování měly název. Další informace o výchozí konfiguraci a beznázvových vazbách a chování najdete v tématu Zjednodušená konfigurace a zjednodušená konfigurace pro služby WCF. |
| openTimeout | Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení otevřené operace. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00. |
| receiveErrorHandling | Hodnota ReceiveErrorHandling , která určuje, jak se zpracovávají jedovaté a nedispatchovatelné zprávy. |
| receiveRetryCount | Celé číslo, které určuje maximální počet okamžitých opakovaných pokusů, by se měl správce fronty pokusit, pokud se přenos zprávy z fronty aplikace do aplikace nezdaří. Pokud se dosáhne maximálního počtu pokusů o doručení a aplikace k této zprávě nepřistupuje, odešle se zpráva do fronty opakování pro opětovné nasazení později. Doba, po kterou se zpráva přenese zpět do odesílající fronty, je řízena retryCycleDelay. Pokud cykly opakování dosáhnou maxRetryCycles hodnoty, zpráva se odešle do fronty otrávených zpráv nebo se odesílateli odešle negativní potvrzení. |
| receiveTimeout | Hodnota TimeSpan , která určuje časový interval určený k dokončení operace příjmu. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:10:00. |
| receiveContextEnabled | Logická hodnota, která určuje, jestli je povolený kontext příjmu pro zpracování zpráv ve frontách. Když je tato možnost nastavená na true, služba může "zobrazit" zprávu ve frontě, aby ji začala zpracovávat, a pokud se něco nepovede a vyvolá se výjimka, zůstane ve frontě. Služby mohou také zprávy "uzamknout", aby bylo možné opakovat zpracování v pozdějším bodu v čase. ReceiveContext poskytuje mechanismus pro "dokončení" zprávy po zpracování, aby ji bylo možné odebrat z fronty. Zprávy se už nepřečtou a znovu zapisují do front přes síť a jednotlivé zprávy se během zpracování nepřeskakují mezi různými instancemi služby. |
| retryCycleDelay | Hodnota TimeSpan, která určuje časové zpoždění mezi cykly opakování při pokusu o doručení zprávy, která se okamžitě nedoručila. Hodnota definuje pouze minimální dobu čekání, protože skutečná doba čekání může být delší. Výchozí hodnota je 00:30:00. Další informace najdete v tématu RetryCycleDelay. |
| sendTimeout | Hodnota TimeSpan , která určuje časový interval určený k dokončení operace odeslání. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00. |
| serializationFormat | Definuje formát použitý pro serializaci textu zprávy. Tento atribut je typu MsmqMessageSerializationFormat. |
| timeToLive | Hodnota TimeSpan, která určuje, jak dlouho jsou zprávy platné před vypršením jejich platnosti, a vložte je do fronty nedoručených zpráv. Výchozí hodnota je 1.00:00:00. Tento atribut je nastavený tak, aby se zajistilo, že zprávy citlivé na čas nebudou zastaralé, než budou zpracovány přijímajícími aplikacemi. Zpráva ve frontě, která není spotřebována přijímající aplikací v zadaném časovém intervalu, má vypršenou platnost. Zprávy s vypršenou platností se odesílají do speciální fronty označované jako fronta nedoručených zpráv. Umístění fronty nedoručených zpráv je nastaveno s atributem DeadLetterQueue nebo na příslušnou výchozí hodnotu na základě záruk. |
| useMsmqTracing | Logická hodnota, která určuje, jestli se mají trasovat zprávy zpracovávané touto vazbou. Výchozí hodnota je false. Pokud je trasování povolené, zprávy sestav se vytvoří a odešlou do fronty sestavy pokaždé, když zpráva opustí nebo dorazí do počítače služby Řízení front zpráv. |
| useSourceJournal | Logická hodnota, která určuje kopie zpráv zpracovávaných touto vazbou, by měla být uložena ve zdrojovém deníku. Výchozí hodnota je false.Aplikace zařazené do fronty, které chtějí uchovávat záznam zpráv, které opustily odchozí frontu počítače, mohou zprávy zkopírovat do fronty deníku. Jakmile zpráva opustí odchozí frontu a přijme se potvrzení, že zpráva byla přijata v cílovém počítači, kopie zprávy se uchovává ve frontě deníku odesílajícího počítače. |
{serializationFormat} Atribut
| Hodnota | Description |
|---|---|
| Xml | Formát XML |
| Binary | Binární formát |
| technologie ActiveX | Formát ActiveX |
| Bytearray | Serializuje objekt na pole bajtů. |
| Stream | Tělo formátované jako datový proud |
Podřízené prvky
| prvek | Description |
|---|---|
| <bezpečnost> | Definuje nastavení zabezpečení pro vazbu. Tento prvek je typu MsmqIntegrationSecurityElement. |
Nadřazené prvky
| prvek | Description |
|---|---|
| <na něčí žádosti> | Tento element obsahuje kolekci standardních a vlastních vazeb. |
Poznámky
Tento element vazby lze použít k tomu, aby aplikace WCF (Windows Communication Foundation) odesílaly zprávy a přijímaly zprávy z existujících aplikací MSMQ, které používají buď nativní rozhraní API modelu COM, MSMQ, nebo typy definované v System.Messaging oboru názvů. Tento element konfigurace můžete použít k určení způsobů adresování fronty, zajištění přenosu, zda zprávy musí být trvale uložené, a způsob ochrany a ověřování zpráv. Další informace naleznete v tématu Postupy: Výměna zpráv pomocí koncových bodů WCF a aplikací řízení front zpráv.
Example
<configuration>
<system.ServiceModel>
<bindings>
<msmqIntegrationBinding>
<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"
maxImmediateRetries="11"
maxRetryCycles="12"
poisonMessageHandling="Disabled"
rejectAfterLastRetry="false"
retryCycleDelay="00:05:55"
timeToLive="00:11:11"
useSourceJournal="true"
useMsmqTracing="true"
serializationFormat="Binary">
<security mode="None" />
</binding>
</msmqIntegrationBinding>
</bindings>
</system.ServiceModel>
</configuration>
Viz také
Spolupracujte s námi na GitHubu
Zdroj tohoto obsahu najdete na GitHubu, kde můžete také vytvářet a kontrolovat problémy a žádosti o přijetí změn. Další informace najdete v našem průvodci pro přispěvatele.
