<msmqIntegration>

Anger en MSMQ-transport för anpassad bindning.

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <msmqIntegration>

Syntax

<msmqIntegration customDeadLetterQueue="Uri"
                 deadLetterQueue="Custom/None/System"
                 durable="Boolean"
                 exactlyOnce="Boolean"
                 manualAddressing="Boolean"
                 maxBufferPoolSize="Integer"
                 maxImmediateRetries="Integer"
                 maxReceivedMessageSize="Integer"
                 maxRetryCycles="Integer"
                 rejectAfterLastRetry="Boolean"
                 retryCycleDelay="TimeSpan"
                 serializationFormat="XML/Binary/ActiveX/ByteArray/Stream"
                 timeToLive="TimeSpan"
                 useSourceJournal="Boolean"
                 useMsmqTracing="Boolean">
  <msmqTransportSecurity>
  </msmqTransportSecurity>
</msmqIntegration>

Typ

Type

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attributes

Attribute Description
customDeadLetterQueue En URI som anger platsen för kön för obeställbara meddelanden per program, där meddelanden som har upphört att gälla eller som inte har levererats till programmet överförs.

För meddelanden som kräver ExactlyOnce-försäkringar (d.v.s exactlyOnce . är inställt på true) är det här attributet standardvärdet för den systemomfattande transaktionella kön med obeställbara bokstäver i MSMQ.

För meddelanden som inte kräver några garantier (d.v.s exactlyOnce . är inställt på false) är det här attributet standardvärdet null.

Värdet måste använda net.msmq-schemat. Standardvärdet är null.

Om deadLetterQueue är inställt på None eller Systemmåste det här attributet anges till null. Om det här attributet inte nulldeadLetterQueue är måste du ange till Custom.
deadLetterQueue Anger vilken typ av kö med obeställbara meddelanden som ska användas.

Giltiga värden inkluderar

– Anpassad: Anpassad deadletter-kö.
- Ingen: Ingen deadletter-kö ska användas.
– System: Använd systemets deadletter-kö.

Det här attributet är av typen DeadLetterQueue.
Hållbara Ett booleskt värde som anger om de meddelanden som bearbetas av den här bindningen är varaktiga eller flyktiga. Standardvärdet är true.

Ett varaktigt meddelande överlever en köhanterares krasch, medan ett flyktigt meddelande inte gör det. Flyktiga meddelanden är användbara när program kräver kortare svarstid och kan tolerera tillfälliga förlorade meddelanden.

Om exactlyOnce är inställt på truemåste meddelandena vara varaktiga.
exactlyOnce Ett booleskt värde som anger om meddelanden som bearbetas av den här bindningen ska tas emot exakt en gång. Standardvärdet är true.

Ett meddelande kan skickas med eller utan garantier. En försäkran gör det möjligt för ett program att se till att ett skickat meddelande nådde den mottagande meddelandekön, eller om det inte gjorde det, kan programmet avgöra detta genom att läsa kön med obeställbara meddelanden.

exactlyOnce, när det är inställt på true, anger att MSMQ ser till att ett skickat meddelande levereras till den mottagande meddelandekön en gång och bara en gång, och om leveransen misslyckas skickas meddelandet till kön med obeställbara meddelanden.

Meddelanden som skickas med exactlyOnce inställd true på måste endast skickas till en transaktionskö.
Manualaddressing Ett booleskt värde som gör att användaren kan ta kontroll över meddelande adressering. Den här egenskapen används vanligtvis i routerscenarier, där programmet avgör vilken av flera mål som ett meddelande ska skickas till.

När det är inställt på förutsätter kanalen att truemeddelandet redan har åtgärdats och lägger inte till någon ytterligare information i det. Användaren kan sedan adressera varje meddelande individuellt.

När inställningen är inställd falsepå skapar standardlösningsmekanismen för Windows Communication Foundation (WCF) automatiskt adresser för alla meddelanden.

Standardvärdet är false.
maxBufferPoolSize Ett positivt heltal som anger den maximala storleken på buffertpoolen. Standardvärdet är 524288.

Många delar av WCF använder buffertar. Att skapa och förstöra buffertar varje gång de används är dyrt, och skräpinsamling för buffertar är också dyrt. Med buffertpooler kan du ta en buffert från poolen, använda den och returnera den till poolen när du är klar. Därmed undviks kostnaderna för att skapa och förstöra buffertar.
maxImmediateRetries Ett heltal som anger det maximala antalet omedelbara återförsök för ett meddelande som läss från programkön. Standardvärdet är 5.

Om det maximala antalet omedelbara återförsök för meddelandet görs och meddelandet inte förbrukas av programmet, skickas meddelandet till en kö för återförsök vid en senare tidpunkt. Om inga återförsökscykler anges skickas meddelandena antingen till giftmeddelandekön eller så skickas en negativ bekräftelse tillbaka till avsändaren.
maxReceivedMessageSize Ett positivt heltal som anger den maximala meddelandestorleken i byte inklusive rubriker. Avsändaren av ett meddelande får ett SOAP-fel när meddelandet är för stort för mottagaren. Mottagaren släpper meddelandet och skapar en post för händelsen i spårningsloggen. Standardvärdet är 65536.
maxRetryCycles Ett heltal som anger det maximala antalet återförsökscykler för att försöka leverera meddelanden till det mottagande programmet. Standardvärdet är MaxValue.

En enda återförsökscykel försöker leverera ett meddelande till ett program ett angivet antal gånger. Antalet försök som görs anges av attributet maxImmediateRetries . Om programmet inte kan använda meddelandet efter att leveransförsöken har uttömts skickas meddelandet till en kö för återförsök. Efterföljande återförsökscykler består av meddelandet som returneras från kön för återförsök till programkön för att försöka leverera till programmet igen, efter en fördröjning som anges av retryCycleDelay attributet. Attributet maxRetryCycles anger antalet återförsökscykler som programmet använder för att försöka leverera meddelandet.
rejectAfterLastRetry Ett booleskt värde som anger vilken åtgärd som ska vidtas för ett meddelande som har misslyckats med leveransen efter att det maximala antalet återförsök har försökts.

true innebär att en negativ bekräftelse returneras till avsändaren och att meddelandet tas bort. false innebär att meddelandet skickas till giftmeddelandekön. Standardvärdet är false.

Om värdet är falsekan det mottagande programmet läsa kön för giftmeddelanden för att bearbeta giftmeddelanden (det vill: meddelanden som har misslyckats med leveransen).

MSMQ 3.0 stöder inte att en negativ bekräftelse returneras till avsändaren, så det här attributet ignoreras i MSMQ 3.0.
retryCycleDelay En TimeSpan som anger tidsfördröjningen mellan återförsökscykler när du försöker leverera ett meddelande som inte kunde levereras omedelbart. Standardvärdet är 00:10:00.

En enda återförsökscykel försöker leverera ett meddelande till ett mottagande program ett angivet antal gånger. Antalet försök som görs anges av attributet maxImmediateRetries . Om programmet inte kan använda meddelandet efter det angivna antalet omedelbara återförsök skickas meddelandet till en kö för återförsök. Efterföljande återförsökscykler består av meddelandet som returneras från kön för återförsök till programkön för att försöka leverera till programmet igen, efter en fördröjning som anges av retryCycleDelay attributet. Antalet återförsökscykler anges med maxRetryCycles attribut.
serializationFormat Anger den formatering som används för att serialisera objekt som skickas som en del av ett MSMQ-meddelande. Giltiga värden är

– ActiveX: ActiveX-formaterare används vid serialisering av COM-objekt.
– Binär: Serialiserar objektet till ett binärt paket.
– ByteArray: Serialiserar objektet till en matris med byte.
– Ström: Serialiserar objektet till en ström.
– Xml: Serialiserar objektet till ett XML-paket. Standardvärdet är XML.

Det här attributet är av typen MsmqMessageSerializationFormat.
timeToLive En TimeSpan som anger hur länge meddelandena är giltiga innan de har upphört att gälla och placeras i kön med obeställbara meddelanden. Standardvärdet är 1.00:00:00, vilket innebär 1 dag.

Det här attributet är inställt för att säkerställa att tidskänsliga meddelanden inte blir inaktuella innan de bearbetas av de mottagande programmen. Ett meddelande i en kö som inte förbrukas av det mottagande programmet inom det angivna tidsintervallet sägs ha upphört att gälla. Utgångna meddelanden skickas till en särskild kö som kallas kön för obeställbara meddelanden. Platsen för kön för obeställbara meddelanden anges med customDeadLetterQueue attributet eller till lämplig standard, baserat på försäkringar.
useMsmqTracing Ett booleskt värde som anger om meddelanden som bearbetas av den här bindningen ska spåras. Standardvärdet är false.

När spårning är aktiverat skapas och skickas rapportmeddelanden till rapportkön varje gång meddelandet lämnar eller anländer till en Message Queuing-dator.
useSourceJournal Ett booleskt värde som anger om kopior av meddelanden som bearbetas av den här bindningen ska lagras i källjournalkön. Standardvärdet är false.

Program i kö som vill behålla en post med meddelanden som har lämnat datorns utgående kö kan kopiera meddelandena till en journalkö. När ett meddelande lämnar den utgående kön och en bekräftelse tas emot om att meddelandet togs emot på måldatorn sparas en kopia av meddelandet i den sändande datorns systemjournalkö.

Underordnade element

Komponent Description
msmqTransportSecurity Anger transportsäkerhetsinställningar för den här bindningen. Det här elementet är av typen MsmqTransportSecurityElement.

Överordnade element

Komponent Description
<bindande> Definierar alla bindningsfunktioner i den anpassade bindningen.

Se även

  • Uppdaterades senast