Partager via

<msmqIntegration>

Spécifie un transport MSMQ pour la liaison personnalisée.

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

Syntaxe

<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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributes

Caractéristique Descriptif
customDeadLetterQueue URI qui indique l’emplacement de la file d’attente de lettres mortes par application, où les messages qui ont expiré ou qui n’ont pas pu être remis à l’application sont transférés.

Pour les messages qui nécessitent des assurances ExactlyOnce (autrement dit, exactlyOnce défini sur true), cet attribut est défini par défaut sur la file d’attente de lettres mortes transactionnelles à l’échelle du système dans MSMQ.

Pour les messages qui ne nécessitent aucune garantie (autrement dit, exactlyOnce est défini sur false), cet attribut est nulldéfini par défaut sur .

La valeur doit utiliser le schéma net.msmq. La valeur par défaut est null.

Si deadLetterQueue la valeur est définie None ou System, cet attribut doit être défini sur null. Si cet attribut n’est pas null, il deadLetterQueue doit être défini sur Custom.
deadLetterQueue Spécifie le type de file d’attente de lettres mortes à utiliser.

Les valeurs valides sont les suivantes :

- Personnalisé : file d’attente de l’inactif personnalisé.
- Aucun : aucune file d’attente de courrier mort n’est à utiliser.
- Système : utilisez la file d’attente du système deadletter.

Cet attribut est de type DeadLetterQueue.
durable Valeur booléenne qui spécifie si les messages traités par cette liaison sont durables ou volatiles. La valeur par défaut est true.

Un message durable survive à un plantage du gestionnaire de files d’attente, tandis qu’un message volatile ne le fait pas. Les messages volatiles sont utiles lorsque les applications nécessitent une latence plus faible et peuvent tolérer des messages perdus occasionnels.

Si exactlyOnce la valeur est définie true, les messages doivent être durables.
exactOnce Valeur booléenne qui spécifie si les messages traités par cette liaison sont reçus exactement une fois. La valeur par défaut est true.

Un message peut être envoyé avec ou sans garanties. Une assurance permet à une application de s’assurer qu’un message envoyé a atteint la file d’attente des messages de réception ou, s’il ne l’a pas fait, l’application peut le déterminer en lisant la file d’attente de lettres mortes.

exactlyOnce, lorsqu’il est défini truesur , indique que MSMQ s’assure qu’un message envoyé est remis à la file d’attente de messages de réception une seule fois et une seule fois, et si la remise échoue, le message est envoyé à la file d’attente de lettres mortes.

Les messages envoyés avec exactlyOnce la valeur true définie doivent être envoyés à une file d’attente transactionnelle uniquement.
manualAddressing Valeur booléenne qui permet à l’utilisateur de prendre le contrôle de l’adressage des messages. Cette propriété est généralement utilisée dans les scénarios de routeur, où l’application détermine l’une des destinations auxquelles envoyer un message.

Lorsqu’il est défini truesur , le canal suppose que le message a déjà été adressé et n’y ajoute aucune information supplémentaire. L’utilisateur peut ensuite traiter chaque message individuellement.

Lorsqu’il est défini falsesur , le mécanisme d’adressage WINDOWS Communication Foundation (WCF) par défaut crée automatiquement des adresses pour tous les messages.

La valeur par défaut est false.
maxBufferPoolSize Entier positif qui spécifie la taille maximale du pool de mémoires tampons. La valeur par défaut est 524288.

De nombreuses parties de WCF utilisent des mémoires tampons. La création et la destruction de mémoires tampons chaque fois qu’elles sont utilisées est coûteuse et le garbage collection pour les mémoires tampons est également coûteux. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon à partir du pool, l’utiliser et la retourner au pool une fois que vous avez terminé. Ainsi, la surcharge dans la création et la destruction de mémoires tampons est évitée.
maxImmediateRetries Entier qui spécifie le nombre maximal de nouvelles tentatives immédiates sur un message lu à partir de la file d’attente de l’application. La valeur par défaut est 5.

Si le nombre maximal de nouvelles tentatives immédiates pour le message est tenté et que le message n’est pas consommé par l’application, le message est envoyé à une file d’attente de nouvelles tentatives à un moment donné. Si aucun cycle de nouvelle tentative n’est spécifié, les messages sont envoyés à la file d’attente de messages incohérents ou un accusé de réception négatif est renvoyé à l’expéditeur.
maxReceivedMessageSize Entier positif qui spécifie la taille maximale du message en octets, y compris les en-têtes. L’expéditeur d’un message reçoit une erreur SOAP lorsque le message est trop volumineux pour le récepteur. Le destinataire supprime le message et crée une entrée de l’événement dans le journal des traces. La valeur par défaut est 65536.
maxRetryCycles Entier qui spécifie le nombre maximal de cycles de nouvelle tentative pour tenter la remise de messages à l’application de réception. La valeur par défaut est MaxValue.

Un cycle de nouvelle tentative unique tente de remettre un message à une application un nombre spécifié de fois. Le nombre de tentatives effectuées est défini par l’attribut maxImmediateRetries . Si l’application ne parvient pas à consommer le message après l’épuisement des tentatives de remise, le message est envoyé à une file d’attente de nouvelles tentatives. Les cycles de nouvelle tentative suivants se composent du message retourné de la file d’attente de nouvelles tentatives vers la file d’attente de l’application pour tenter à nouveau la remise à l’application, après un délai spécifié par l’attribut retryCycleDelay . L’attribut maxRetryCycles spécifie le nombre de cycles de nouvelle tentative que l’application utilise pour tenter de remettre le message.
rejectAfterLastRetry Valeur booléenne qui spécifie l’action à entreprendre pour un message ayant échoué après la tentative maximale de nouvelles tentatives.

true signifie qu’un accusé de réception négatif est retourné à l’expéditeur et que le message est supprimé ; false signifie que le message est envoyé à la file d’attente de messages incohérents. La valeur par défaut est false.

Si la valeur est false, l’application de réception peut lire la file d’attente de messages incohérents pour traiter les messages incohérents (autrement dit, les messages ayant échoué la remise).

MSMQ 3.0 ne prend pas en charge le renvoi d’un accusé de réception négatif à l’expéditeur. Cet attribut sera donc ignoré dans MSMQ 3.0.
retryCycleDelay Qui TimeSpan spécifie le délai entre les cycles de nouvelle tentative lors de la tentative de remise d’un message qui n’a pas pu être remis immédiatement. La valeur par défaut est 00:10:00.

Un cycle de nouvelle tentative unique tente de remettre un message à une application de réception un nombre spécifié de fois. Le nombre de tentatives effectuées est spécifié par l’attribut maxImmediateRetries . Si l’application ne parvient pas à consommer le message après le nombre spécifié de nouvelles tentatives immédiates, le message est envoyé à une file d’attente de nouvelles tentatives. Les cycles de nouvelle tentative suivants se composent du message retourné de la file d’attente de nouvelles tentatives vers la file d’attente de l’application pour tenter à nouveau la remise à l’application, après un délai spécifié par l’attribut retryCycleDelay . Le nombre de cycles de nouvelle tentative est spécifié par maxRetryCycles attribut.
serializationFormat Spécifie le formateur utilisé pour sérialiser les objets envoyés dans le cadre d’un message MSMQ. Les valeurs valides sont

- ActiveX : le formateur ActiveX est utilisé lors de la sérialisation d’objets COM.
- Binaire : sérialise l’objet vers un paquet binaire.
- ByteArray : sérialise l’objet dans un tableau d’octets.
- Flux : sérialise l’objet vers un flux.
- Xml : sérialise l’objet dans un paquet XML. La valeur par défaut est XML.

Cet attribut est de type MsmqMessageSerializationFormat.
timeToLive Qui TimeSpan spécifie la durée pendant laquelle les messages sont valides avant leur expiration et sont placés dans la file d’attente de lettres mortes. La valeur par défaut est 1.00:00:00, ce qui signifie 1 jour.

Cet attribut est défini pour s’assurer que les messages sensibles au temps ne deviennent pas obsolètes avant qu’ils ne soient traités par les applications de réception. Un message dans une file d’attente qui n’est pas consommée par l’application de réception dans l’intervalle de temps spécifié est dit expiré. Les messages expirés sont envoyés à une file d’attente spéciale appelée file d’attente de lettres mortes. L’emplacement de la file d’attente de lettres mortes est défini avec l’attribut customDeadLetterQueue ou la valeur par défaut appropriée, en fonction des assurances.
useMsmqTracing Valeur booléenne qui spécifie si les messages traités par cette liaison doivent être suivis. La valeur par défaut est false.

Lorsque le suivi est activé, les messages de rapport sont créés et envoyés à la file d’attente du rapport chaque fois que le message quitte ou arrive à un ordinateur Message Queuing.
useSourceJournal Valeur booléenne qui spécifie si les copies des messages traités par cette liaison doivent être stockées dans la file d’attente du journal source. La valeur par défaut est false.

Les applications en file d’attente qui souhaitent conserver un enregistrement des messages qui ont quitté la file d’attente sortante de l’ordinateur peuvent copier les messages dans une file d’attente de journal. Une fois qu’un message quitte la file d’attente sortante et qu’un accusé de réception est reçu sur l’ordinateur de destination, une copie du message est conservée dans la file d’attente du journal système de l’ordinateur d’envoi.

Éléments enfants

Élément Descriptif
msmqTransportSecurity Spécifie les paramètres de sécurité de transport pour cette liaison. Cet élément est de type MsmqTransportSecurityElement.

Éléments parents

Élément Descriptif
<reliure> Définit toutes les fonctionnalités de liaison de la liaison personnalisée.

Voir aussi

  • Last updated on