<msmqTransport>

Artigo
06/08/2023

Faz com que um canal transfira mensagens sobre o transporte MSMQ quando ele é incluído em uma associação personalizada.

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

Syntax

<msmqTransport customDeadLetterQueue="Uri"
               deadLetterQueue="Custom/None/System"
               durable="Boolean"
               exactlyOnce="Boolean"
               manualAddressing="Boolean"
               maxBufferPoolSize="Integer"
               maxImmediateRetries="Integer"
               maxPoolSize="Integer"
               maxReceivedMessageSize="Integer"
               maxRetryCycles="Integer"
               queueTransferProtocol="Native/Srmp/SrmpSecure"
               rejectAfterLastRetry="Boolean"
               retryCycleDelay="TimeSpan"
               timeToLive="TimeSpan"
               useActiveDirectory="Boolean"
               useSourceJournal="Boolean"
               useMsmqTracing="Boolean"
               ...>
  <msmqTransportSecurity>
  </msmqTransportSecurity>
</msmqTransport>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
customDeadLetterQueue	Um URI que indica o local da fila de mensagens mortas por aplicativo, em que as mensagens que venceram ou que não foram entregues ao aplicativo são transferidas. Para as mensagens que exigem garantias ExactlyOnce (ou seja, `exactlyOnce` está definido como `true`), esse atributo é o padrão para a fila de mensagens mortas transacionais em todo o sistema no MSMQ. Para as mensagens que não exigem garantias (ou seja, `exactlyOnce` está definido como `false`), esse atributo usa `null` como padrão. O valor precisa usar o esquema net.msmq. O padrão é `null`. Se `deadLetterQueue` estiver definido como `None` ou `System`, esse atributo precisará ser definido como `null`. Se esse atributo não for `null`, `deadLetterQueue` precisará ser definido como `Custom`.
deadLetterQueue	Especifica o tipo de fila de mensagens mortas a ser usado. Os valores válidos incluem – Personalizado: fila de mensagens mortas personalizada. – Nenhum: nenhuma fila de mensagens mortas deve ser usada. – Sistema: usa a fila de mensagens mortas do sistema. Esse atributo é do tipo DeadLetterQueue.
durável	Um valor booliano que especifica se as mensagens processadas por essa associação são duráveis ou voláteis. O padrão é `true`. Uma mensagem durável sobrevive a uma falha do gerenciador de filas, ao contrário de uma mensagem volátil. As mensagens voláteis são úteis quando os aplicativos exigem latência mais baixa e podem tolerar mensagens perdidas ocasionais. Se `exactlyOnce` estiver definido como `true`, as mensagens precisarão ser duráveis.
exactlyOnce	Um valor booliano que indica se as mensagens processadas por essa associação serão recebidas exatamente uma vez. O padrão é `true`. Uma mensagem pode ser enviada com ou sem garantias. Uma garantia permite que um aplicativo verifique se uma mensagem enviada chegou à fila de mensagens recebidas ou, se ela não chegou, o aplicativo poderá determinar isso lendo a fila de mensagens mortas. `exactlyOnce`, quando definido como `true`, indica que o MSMQ garantirá que uma mensagem enviada seja entregue à fila de mensagens de recebimento uma e apenas uma vez e, se a entrega falhar, a mensagem será enviada para a fila de mensagens mortas. As mensagens enviadas com `exactlyOnce` definidas como `true` precisam ser enviadas somente para uma fila transacional.
manualAddressing	Um valor booliano que permite que o usuário assuma o controle do endereçamento de mensagens. Essa propriedade geralmente é usada em cenários de roteador, em que o aplicativo determina para qual dos vários destinos ele enviará uma mensagem. Quando ele está definido como `true`, o canal pressupõe que a mensagem já foi endereçada e não adiciona nenhuma informação adicional a ela. Em seguida, o usuário pode endereçar cada mensagem individualmente. Quando ele está definido como `false`, o mecanismo de endereçamento padrão do WCF (Windows Communication Foundation) cria automaticamente endereços para todas as mensagens. O padrão é `false`.
maxBufferPoolSize	Um inteiro positivo que especifica o tamanho máximo do pool de buffers. O padrão é 524.288. Muitas partes do WCF usam buffers. Criar e destruir buffers cada vez que eles são usados é caro, e a coleta de lixo para buffers também é cara. Com os pools de buffers, você pode pegar um buffer do pool, usá-lo e devolvê-lo ao pool assim que terminar. Portanto, a sobrecarga na criação e na destruição de buffers é evitada.
maxImmediateRetries	Um inteiro que especifica o número máximo de tentativas de repetição imediatas em uma mensagem que é lida da fila do aplicativo. O padrão é 5. Se o número máximo de tentativas imediatas para a mensagem for realizado e a mensagem não for consumida pelo aplicativo, a mensagem será enviada para uma fila de repetição para nova tentativa em algum momento posterior. Se nenhum ciclo de repetição for especificado, as mensagens serão enviadas para a fila de mensagens suspeitas ou uma confirmação negativa será enviada novamente ao remetente.
maxPoolSize	Um inteiro positivo que especifica o tamanho máximo do pool. O padrão é 524.288.
maxReceivedMessageSize	Um inteiro positivo que especifica o tamanho máximo da mensagem em bytes, incluindo os cabeçalhos. O remetente de uma mensagem recebe uma falha SOAP quando a mensagem é muito grande para o destinatário. O destinatário remove a mensagem e cria uma entrada do evento no log de rastreamento. O padrão é 65.536.
maxRetryCycles	Um inteiro que especifica o número máximo de ciclos de repetição para tentativa de entrega das mensagens ao aplicativo de recebimento. O padrão é MaxValue. Um só ciclo de repetição tenta entregar uma mensagem a um aplicativo um número especificado de vezes. O número de tentativas feitas é definido pelo atributo `maxImmediateRetries`. Se o aplicativo não consumir a mensagem depois que as tentativas de entrega tiverem sido esgotadas, a mensagem será enviada para uma fila de repetição. Os ciclos de repetição seguintes consistem na mensagem retornada da fila de repetição para a fila do aplicativo para tentar entregar o aplicativo novamente, após um atraso especificado pelo atributo `retryCycleDelay`. O atributo `maxRetryCycles` especifica o número de ciclos de repetição que o aplicativo usa para tentar entregar a mensagem.
queueTransferProtocol	Especifica o transporte de canal de comunicação em fila usado por essa associação. Os valores válidos são – Nativo: usa o protocolo nativo do MSMQ. – Srmp: usa o protocolo SRMP (Soap Reliable Messaging Protocol). – SrmpSecure: usa o transporte SRMPS (Soap Reliable Messaging Protocol Secure). Esse atributo é do tipo QueueTransferProtocol. Como o MSMQ não dá suporte ao endereçamento do Active Directory ao usar o protocolo SOAP Reliable Messaging, não defina esse atributo como Srmp ou Srmps quando `useActiveDirectory` estiver definido como `true`.
rejectAfterLastRetry	Um valor booliano que especifica a ação a ser tomada para uma mensagem que falhou na entrega após a tentativa de número máximo de tentativas. `true` significa que uma confirmação negativa é retornada ao remetente e a mensagem é descartada. `false` significa que a mensagem é enviada para a fila de mensagens suspeitas. O padrão é `false`. Se o valor for `false`, o aplicativo de recebimento poderá ler a fila de mensagens suspeitas para processar mensagens suspeitas (ou seja, as mensagens que falharam na entrega). O MSMQ 3.0 não dá suporte ao retorno de uma confirmação negativa ao remetente, ou seja, esse atributo será ignorado no MSMQ 3.0.
retryCycleDelay	Um TimeSpan que especifica o atraso de tempo entre os ciclos de repetição de tentativa de entrega de uma mensagem que não pôde ser entregue imediatamente. O padrão é 00:10:00. Um só ciclo de repetição tenta entregar uma mensagem a um aplicativo de recebimento um número especificado de vezes. O número de tentativas feitas é especificado pelo atributo `maxImmediateRetries`. Se o aplicativo não consumir a mensagem após o número especificado de repetições imediatas, a mensagem será enviada para uma fila de repetição. Os ciclos de repetição seguintes consistem na mensagem retornada da fila de repetição para a fila do aplicativo para tentar entregar o aplicativo novamente, após um atraso especificado pelo atributo `retryCycleDelay`. O número de ciclos de repetição é especificado pelo atributo `maxRetryCycles`.
timeToLive	Um TimeSpan que especifica quanto tempo as mensagens são válidas antes de vencerem e serem colocadas na fila de mensagens mortas. O padrão é 1.00:00:00, o que significa um dia. Esse atributo está definido para garantir que as mensagens sensíveis ao tempo não fiquem obsoletas antes de serem processadas pelos aplicativos de recebimento. Uma mensagem em uma fila que não é consumida pelo aplicativo de recebimento dentro do intervalo de tempo especificado é considerada vencida. As mensagens vencidas são enviadas para uma fila especial chamada fila de mensagens mortas. O local da fila de mensagens mortas é definido com o atributo `customDeadLetterQueue` ou com o padrão apropriado, de acordo com as garantias.
UseActiveDirectory	Um valor booliano que especifica se os endereços da fila devem ser convertidos usando o Active Directory. Os endereços da fila MSMQ podem consistir em nomes de caminho ou nomes de formato direto. Com um nome de formato direto, o MSMQ resolve o nome do computador usando DNS, NetBIOS ou IP. Com um nome de caminho, o MSMQ resolve o nome do computador usando o Active Directory. Por padrão, o transporte enfileirado do WCF (Windows Communication Framework) converte o URI de uma fila de mensagens em um nome de formato direto. Ao definir esse atributo como `true`, um aplicativo pode especificar que o transporte enfileirado deve resolver o nome do computador usando o Active Directory em vez de DNS, NetBIOS ou IP.
useMsmqTracing	Um valor booliano que especifica se as mensagens processadas por essa associação devem ser rastreadas. O padrão é `false`. Quando o rastreamento está habilitado, as mensagens de relatório são criadas e enviadas para a fila de relatórios sempre que a mensagem sai ou chega em um computador do Enfileiramento de Mensagens.
useSourceJournal	Um valor booliano que especifica se as cópias de mensagens processadas por essa associação devem ser armazenadas na fila de diários de origem. O padrão é `false`. Os aplicativos na fila que desejam manter um registro das mensagens que saíram da fila de saída do computador podem copiar as mensagens para uma fila de diários. Depois que uma mensagem sai da fila de saída e uma confirmação é recebida de que a mensagem foi recebida no computador de destino, uma cópia da mensagem é mantida na fila de diários do sistema de envio.

Elementos filho

Elemento	Descrição
<msmqTransportSecurity>	Especifica as configurações de segurança do transporte para essa associação. Esse elemento é do tipo MsmqTransportSecurityElement.

Elementos pai

Elemento	Descrição
<binding>	Define todas as funcionalidades de associação da associação personalizada.

Comentários

O elemento msmqTransport permite que o usuário defina as propriedades do canal de comunicação enfileirado. O canal de comunicação enfileirado usa o Enfileiramento de Mensagens para transporte.

Esse elemento de associação é o elemento de associação padrão usado pela associação padrão de Enfileiramento de Mensagens (netMsmqBinding).

Compartilhar via