<msmqIntegration>

Hiermee geeft u een MSMQ-transport voor aangepaste binding.

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

Syntaxis

<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>

Type

Type

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Attributes

Attribute Description
customDeadLetterQueue Een URI die de locatie aangeeft van de wachtrij voor dead letter per toepassing, waarbij berichten die zijn verlopen of niet aan de toepassing kunnen worden bezorgd, worden overgedragen.

Voor berichten waarvoor ExactlyOnce-garanties zijn vereist (dat wil zeggen, exactlyOnce is ingesteld op true), wordt dit kenmerk standaard ingesteld op de systeembrede transactionele wachtrij voor dead-letter in MSMQ.

Voor berichten waarvoor geen garanties zijn vereist (dat wil gezegd, exactlyOnce is ingesteld op false), wordt dit kenmerk standaard ingesteld nullop .

De waarde moet het net.msmq-schema gebruiken. De standaardwaarde is null.

Als deadLetterQueue dit is ingesteld op None of System, moet dit kenmerk worden ingesteld op null. Als dit kenmerk niet nullis, deadLetterQueue moet deze worden ingesteld op Custom.
deadLetterQueue Hiermee geeft u het type wachtrij voor dode letters te gebruiken.

Geldige waarden zijn onder meer

- Aangepast: Aangepaste wachtrij voor deadletters.
- Geen: Er moet geen deadletterwachtrij worden gebruikt.
- Systeem: Gebruik de wachtrij voor deadletters van het systeem.

Dit kenmerk is van het type DeadLetterQueue.
Duurzaam Een Booleaanse waarde die aangeeft of de berichten die door deze binding worden verwerkt, duurzaam of vluchtig zijn. De standaardwaarde is true.

Een duurzaam bericht overleeft het vastlopen van een wachtrijbeheerder, terwijl een vluchtig bericht dat niet gebeurt. Vluchtige berichten zijn handig wanneer toepassingen een lagere latentie vereisen en soms verloren berichten kunnen tolereren.

Als exactlyOnce deze optie is ingesteld true, moeten de berichten duurzaam zijn.
exactlyOnce Een Booleaanse waarde die aangeeft of berichten die door deze binding worden verwerkt, precies eenmaal worden ontvangen. De standaardwaarde is true.

Een bericht kan worden verzonden met of zonder garanties. Met een zekerheid kan een toepassing ervoor zorgen dat een verzonden bericht de ontvangende berichtenwachtrij heeft bereikt, of als dit niet zo is, kan de toepassing dit bepalen door de wachtrij met dode brieven te lezen.

exactlyOnce, indien ingesteld op true, geeft aan dat MSMQ ervoor zorgt dat een verzonden bericht eenmaal en slechts één keer wordt bezorgd in de ontvangende berichtenwachtrij, en als de bezorging mislukt, wordt het bericht verzonden naar de wachtrij met dode brieven.

Berichten die zijn verzonden met exactlyOnce de set moeten true alleen naar een transactionele wachtrij worden verzonden.
manualAddressing Een Booleaanse waarde waarmee de gebruiker de controle over berichtadressering kan overnemen. Deze eigenschap wordt meestal gebruikt in routerscenario's, waarbij de toepassing bepaalt naar welke van de verschillende bestemmingen een bericht moet worden verzonden.

Als deze optie is ingesteld true, wordt ervan uitgegaan dat het bericht al is geadresseerd en er geen aanvullende informatie aan wordt toegevoegd. De gebruiker kan vervolgens elk bericht afzonderlijk adressen.

Als dit is ingesteld falseop, maakt het standaard WCF-adresseringsmechanisme (Windows Communication Foundation) automatisch adressen voor alle berichten.

De standaardwaarde is false.
maxBufferPoolSize Een positief geheel getal dat de maximale grootte van de buffergroep aangeeft. De standaardwaarde is 524288.

Veel onderdelen van WCF maken gebruik van buffers. Het maken en vernietigen van buffers telkens wanneer ze worden gebruikt, is duur en garbagecollection voor buffers is ook duur. Met buffergroepen kunt u een buffer uit de pool nemen, deze gebruiken en teruggaan naar de pool zodra u klaar bent. De overhead bij het maken en vernietigen van buffers wordt dus vermeden.
maxImmediateRetries Een geheel getal dat het maximum aantal onmiddellijke nieuwe pogingen opgeeft voor een bericht dat wordt gelezen uit de toepassingswachtrij. De standaardwaarde is 5.

Als het maximum aantal onmiddellijke nieuwe pogingen voor het bericht wordt geprobeerd en het bericht niet wordt gebruikt door de toepassing, wordt het bericht verzonden naar een wachtrij voor opnieuw proberen om het later op een later tijdstip opnieuw te proberen. Als er geen nieuwe pogingen zijn opgegeven, worden de berichten verzonden naar de wachtrij voor gifberichten of wordt een negatieve bevestiging teruggestuurd naar de afzender.
maxReceivedMessageSize Een positief geheel getal dat de maximale berichtgrootte in bytes aangeeft, inclusief kopteksten. De afzender van een bericht ontvangt een SOAP-fout wanneer het bericht te groot is voor de ontvanger. De ontvanger laat het bericht vallen en maakt een vermelding van de gebeurtenis in het traceerlogboek. De standaardwaarde is 65536.
maxRetryCycles Een geheel getal dat het maximum aantal nieuwe pogingen aangeeft om berichten te verzenden naar de ontvangende toepassing. De standaardwaarde is MaxValue.

Met één cyclus voor opnieuw proberen wordt geprobeerd een bericht te verzenden naar een toepassing een bepaald aantal keren. Het aantal pogingen wordt ingesteld door het maxImmediateRetries kenmerk. Als de toepassing het bericht niet kan gebruiken nadat de bezorgingspogingen zijn uitgeput, wordt het bericht verzonden naar een wachtrij voor opnieuw proberen. Volgende nieuwe pogingencycli bestaan uit het bericht dat wordt geretourneerd vanuit de wachtrij voor opnieuw proberen naar de toepassingswachtrij om opnieuw te proberen de toepassing af te leveren, na een vertraging die is opgegeven door het retryCycleDelay kenmerk. Het maxRetryCycles kenmerk geeft het aantal nieuwe pogingen aan dat de toepassing gebruikt om het bericht te bezorgen.
rejectAfterLastRetry Een Booleaanse waarde die aangeeft welke actie moet worden ondernomen voor een bericht dat is mislukt nadat het maximum aantal nieuwe pogingen is geprobeerd.

true betekent dat een negatieve bevestiging wordt geretourneerd aan de afzender en het bericht wordt verwijderd; false betekent dat het bericht wordt verzonden naar de wachtrij met gifberichten. De standaardwaarde is false.

Als de waarde is, kan de ontvangende toepassing de wachtrij voor gifberichten lezen om gifberichten te verwerken (dat wil falsegezegd berichten die zijn mislukte bezorging).

MSMQ 3.0 biedt geen ondersteuning voor het retourneren van een negatieve bevestiging aan de afzender, dus dit kenmerk wordt genegeerd in MSMQ 3.0.
retryCycleDelay Een TimeSpan die de tijdsvertraging aangeeft tussen cycli voor opnieuw proberen bij het bezorgen van een bericht dat niet onmiddellijk kan worden afgeleverd. De standaardwaarde is 00:10:00.

Eén cyclus voor opnieuw proberen probeert een bericht te verzenden naar een ontvangende toepassing een opgegeven aantal keren. Het aantal pogingen wordt opgegeven door het maxImmediateRetries kenmerk. Als de toepassing het bericht niet kan gebruiken na het opgegeven aantal onmiddellijke nieuwe pogingen, wordt het bericht verzonden naar een wachtrij voor opnieuw proberen. Volgende nieuwe pogingencycli bestaan uit het bericht dat wordt geretourneerd vanuit de wachtrij voor opnieuw proberen naar de toepassingswachtrij om opnieuw te proberen de toepassing af te leveren, na een vertraging die is opgegeven door het retryCycleDelay kenmerk. Het aantal nieuwe pogingen wordt opgegeven per maxRetryCycles kenmerk.
serializationFormat Hiermee geeft u de formatter op die wordt gebruikt voor het serialiseren van objecten die worden verzonden als onderdeel van een MSMQ-bericht. Geldige waarden zijn

- ActiveX: De ActiveX-formatter wordt gebruikt bij het serialiseren van COM-objecten.
- Binair: Serialiseert het object naar een binair pakket.
- ByteArray: serialiseert het object naar een matrix van bytes.
- Stream: Serialiseert het object naar een stroom.
- Xml: Serialiseert het object naar een XML-pakket. De standaardwaarde is XML.

Dit kenmerk is van het type MsmqMessageSerializationFormat.
timeToLive Een TimeSpan die aangeeft hoe lang de berichten geldig zijn voordat ze verlopen en in de wachtrij met dode letters worden geplaatst. De standaardwaarde is 1.00:00:00, wat 1 dag betekent.

Dit kenmerk is ingesteld om ervoor te zorgen dat tijdgevoelige berichten niet verlopen voordat ze worden verwerkt door de ontvangende toepassingen. Een bericht in een wachtrij dat niet wordt gebruikt door de ontvangende toepassing binnen het opgegeven tijdsinterval, wordt gezegd dat deze is verlopen. Verlopen berichten worden verzonden naar een speciale wachtrij, de wachtrij voor dode berichten. De locatie van de wachtrij voor dode brieven wordt ingesteld met het customDeadLetterQueue kenmerk of op de juiste standaardwaarde, op basis van garanties.
useMsmqTracing Een Booleaanse waarde die aangeeft of berichten die door deze binding worden verwerkt, moeten worden getraceerd. De standaardwaarde is false.

Wanneer tracering is ingeschakeld, worden rapportberichten gemaakt en naar de rapportwachtrij verzonden telkens wanneer het bericht vertrekt of op een Message Queuing-computer aankomt.
useSourceJournal Een Booleaanse waarde die aangeeft of kopieën van berichten die door deze binding worden verwerkt, moeten worden opgeslagen in de wachtrij van het bronlogboek. De standaardwaarde is false.

Toepassingen in de wachtrij die een record willen bewaren van berichten die de uitgaande wachtrij van de computer hebben verlaten, kunnen de berichten naar een logboekwachtrij kopiëren. Zodra een bericht de uitgaande wachtrij verlaat en er een bevestiging wordt ontvangen dat het bericht is ontvangen op de doelcomputer, wordt een kopie van het bericht bewaard in de systeemlogboekwachtrij van de verzendende computer.

Kind-elementen

Onderdeel Description
msmqTransportSecurity Hiermee geeft u transportbeveiligingsinstellingen voor deze binding. Dit element is van het type MsmqTransportSecurityElement.

Bovenliggende elementen

Onderdeel Description
<bindend> Definieert alle bindingsmogelijkheden van de aangepaste binding.

Zie ook

  • Last updated on