`<msmqIntegration>`

Especifica un transporte de MSMQ para el enlace personalizado.

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

Tipo

Type

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Attributes

Atributo	Description
customDeadLetterQueue	URI que indica la ubicación de la cola de mensajes fallidos por aplicación, donde se transfieren los mensajes que han expirado o no se han entregado a la aplicación. Para los mensajes que requieren garantías de ExactlyOnce (es decir, `exactlyOnce` se establece `true`en ), este atributo tiene como valor predeterminado la cola de mensajes fallidos transaccionales de todo el sistema en MSMQ. Para los mensajes que no requieren garantías (es decir, `exactlyOnce` se establece `false`en ), este atributo tiene `null`como valor predeterminado . El valor debe usar el esquema net.msmq. El valor predeterminado es `null`. Si `deadLetterQueue` se establece en `None` o `System`, este atributo debe establecerse `null`en . Si este atributo no `null`es , `deadLetterQueue` debe establecerse `Custom`en .
deadLetterQueue	Especifica el tipo de cola de mensajes fallidos que se va a usar. Los valores válidos incluyen - Personalizado: cola de mensajes fallidos personalizado. - Ninguno: no se va a usar ninguna cola de mensajes fallidos. - Sistema: use la cola de mensajes fallidos del sistema. Este atributo es de tipo DeadLetterQueue.
Durable	Valor booleano que especifica si los mensajes procesados por este enlace son duraderos o volátiles. El valor predeterminado es `true`. Un mensaje duradero sobrevive a un bloqueo del administrador de colas, mientras que un mensaje volátil no lo hace. Los mensajes volátiles son útiles cuando las aplicaciones requieren una menor latencia y pueden tolerar mensajes perdidos ocasionales. Si `exactlyOnce` se establece en `true`, los mensajes deben ser duraderos.
exactlyOnce	Valor booleano que especifica si los mensajes procesados por este enlace se recibirán exactamente una vez. El valor predeterminado es `true`. Se puede enviar un mensaje con o sin garantías. Una garantía permite a una aplicación asegurarse de que un mensaje enviado alcanzó la cola de mensajes receptores o, si no lo hizo, la aplicación puede determinarlo leyendo la cola de mensajes fallidos. `exactlyOnce`, cuando se establece `true`en , indica que MSMQ garantizará que un mensaje enviado se entregue a la cola de mensajes receptoras una vez y solo una vez y, si se produce un error en la entrega, el mensaje se envía a la cola de mensajes fallidos. Los mensajes enviados con `exactlyOnce` establecido en `true` deben enviarse solo a una cola transaccional.
manualAddressing	Valor booleano que permite al usuario tomar el control de direccionamiento de mensajes. Esta propiedad se usa normalmente en escenarios de enrutador, donde la aplicación determina a qué uno de varios destinos enviar un mensaje. Cuando se establece `true`en , el canal supone que el mensaje ya se ha solucionado y no agrega información adicional a él. A continuación, el usuario puede dirigir cada mensaje individualmente. Cuando se establece en `false`, el mecanismo de direccionamiento predeterminado de Windows Communication Foundation (WCF) crea automáticamente direcciones para todos los mensajes. El valor predeterminado es `false`.
maxBufferPoolSize	Entero positivo que especifica el tamaño máximo del grupo de búferes. El valor predeterminado es 524288. Muchas partes de WCF usan búferes. La creación y destrucción de búferes cada vez que se usan es costosa y la recolección de elementos no utilizados para los búferes también es costosa. Con los grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo una vez que haya terminado. Por lo tanto, se evita la sobrecarga en la creación y destrucción de búferes.
maxImmediateRetries	Entero que especifica el número máximo de reintentos inmediatos en un mensaje leído de la cola de aplicaciones. El valor predeterminado es 5. Si se intenta el número máximo de reintentos inmediatos para el mensaje y la aplicación no consume el mensaje, el mensaje se envía a una cola de reintento para reintentar en algún momento posterior. Si no se especifican ciclos de reintento, los mensajes se envían a la cola de mensajes dudosos o se devuelve una confirmación negativa al remitente.
maxReceivedMessageSize	Entero positivo que especifica el tamaño máximo del mensaje en bytes, incluidos los encabezados. El remitente de un mensaje recibe un error soap cuando el mensaje es demasiado grande para el receptor. El receptor quita el mensaje y crea una entrada del evento en el registro de seguimiento. El valor predeterminado es 65536.
maxRetryCycles	Entero que especifica el número máximo de ciclos de reintento para intentar la entrega de mensajes a la aplicación receptora. El valor predeterminado es MaxValue. Un único ciclo de reintento intenta entregar un mensaje a una aplicación un número especificado de veces. El atributo establece el `maxImmediateRetries` número de intentos realizados. Si la aplicación no consume el mensaje después de que se hayan agotado los intentos de entrega, el mensaje se envía a una cola de reintento. Los ciclos de reintento posteriores constan del mensaje que se devuelve de la cola de reintento a la cola de aplicaciones para intentar la entrega a la aplicación de nuevo, después de un retraso especificado por el `retryCycleDelay` atributo . El `maxRetryCycles` atributo especifica el número de ciclos de reintento que usa la aplicación para intentar entregar el mensaje.
rejectAfterLastRetry	Valor booleano que especifica qué acción realizar para un mensaje que ha producido un error en la entrega después de haber intentado el número máximo de reintentos. `true` significa que se devuelve una confirmación negativa al remitente y se quita el mensaje; `false` significa que el mensaje se envía a la cola de mensajes dudosos. El valor predeterminado es `false`. Si el valor es `false`, la aplicación receptora puede leer la cola de mensajes dudosos para procesar mensajes dudosos (es decir, mensajes que han producido un error en la entrega). MSMQ 3.0 no admite la devolución de una confirmación negativa al remitente, por lo que este atributo se omitirá en MSMQ 3.0.
retryCycleDelay	que TimeSpan especifica el retraso de tiempo entre los ciclos de reintento al intentar entregar un mensaje que no se pudo entregar inmediatamente. El valor predeterminado es 00:10:00. Un único ciclo de reintento intenta entregar un mensaje a una aplicación receptora un número especificado de veces. El atributo especifica el `maxImmediateRetries` número de intentos realizados. Si la aplicación no consume el mensaje después del número especificado de reintentos inmediatos, el mensaje se envía a una cola de reintento. Los ciclos de reintento posteriores constan del mensaje que se devuelve de la cola de reintento a la cola de aplicaciones para intentar la entrega a la aplicación de nuevo, después de un retraso especificado por el `retryCycleDelay` atributo . El atributo especifica `maxRetryCycles` el número de ciclos de reintento.
serializationFormat	Especifica el formateador que se usa para serializar objetos que se envían como parte de un mensaje MSMQ. Los valores válidos son - ActiveX: el formateador ActiveX se usa al serializar objetos COM. - Binario: serializa el objeto en un paquete binario. - ByteArray: serializa el objeto en una matriz de bytes. - Stream: serializa el objeto en una secuencia. - Xml: serializa el objeto en un paquete XML. El valor predeterminado es XML. Este atributo es de tipo MsmqMessageSerializationFormat.
timeToLive	que TimeSpan especifica cuánto tiempo son válidos los mensajes antes de que expiren y se colocan en la cola de mensajes fallidos. El valor predeterminado es 1.00:00:00, lo que significa 1 día. Este atributo se establece para asegurarse de que los mensajes sensibles al tiempo no se vuelven obsoletos antes de que las aplicaciones receptoras los procesen. Se dice que ha expirado un mensaje de una cola que no consume la aplicación receptora dentro del intervalo de tiempo especificado. Los mensajes expirados se envían a una cola especial denominada cola de mensajes fallidos. La ubicación de la cola de mensajes fallidos se establece con el `customDeadLetterQueue` atributo o con el valor predeterminado adecuado, en función de las garantías.
useMsmqTracing	Valor booleano que especifica si se deben realizar seguimientos de los mensajes procesados por este enlace. El valor predeterminado es `false`. Cuando se habilita el seguimiento, los mensajes de informe se crean y envían a la cola de informes cada vez que el mensaje sale o llega a un equipo de Message Queuing.
useSourceJournal	Valor booleano que especifica si las copias de los mensajes procesados por este enlace deben almacenarse en la cola del diario de origen. El valor predeterminado es `false`. Las aplicaciones en cola que desean mantener un registro de los mensajes que han dejado la cola saliente del equipo pueden copiar los mensajes en una cola de diario. Una vez que un mensaje deja la cola saliente y se recibe una confirmación de que el mensaje se recibió en el equipo de destino, se mantiene una copia del mensaje en la cola del diario del sistema del equipo de envío.

Elementos secundarios

Elemento	Description
msmqTransportSecurity	Especifica la configuración de seguridad de transporte para este enlace. Este elemento es de tipo MsmqTransportSecurityElement.

Elementos primarios

Elemento	Description
<encuadernación>	Define todas las funcionalidades de enlace del enlace personalizado.

Consulte también

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-12-19