<msmqIntegration>

Especifica um transporte MSMQ para binding personalizado.

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

Sintaxe

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

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

Attributes

Attribute Description
customDeadLetterQueue Um URI que indica a localização da fila de cartas mortas por aplicação, onde as mensagens que expiraram ou não foram entregues à aplicação são transferidas.

Para mensagens que requerem garantias ExactlyOnce (isto é, exactlyOnce está definida para true), este atributo corresponde por defeito à fila transacional de dead-letter a nível do sistema no MSMQ.

Para mensagens que não requerem garantias (isto é, exactlyOnce é definido para false), este atributo é predefinido para null.

O valor deve usar o esquema net.msmq. A predefinição é null.

Se deadLetterQueue for definido como None ou System, então este atributo deve ser definido como null. Se este atributo não nullfor , então deadLetterQueue deve ser definido como Custom.
deadLetterQueue Especifica o tipo de fila de cartas mortas a usar.

Valores válidos incluem

- Personalizado: Fila personalizada de deadletters.
- Nenhum: Não deve ser usada fila de deadletter.
- Sistema: Usar a fila de deadletter do sistema.

Este atributo é do tipo DeadLetterQueue.
durável Um valor booleano que especifica se as mensagens processadas por esta ligação são duráveis ou voláteis. A predefinição é true.

Uma mensagem duradoura sobrevive a um crash do gestor de filas, enquanto uma mensagem volátil não. Mensagens voláteis são úteis quando as aplicações requerem menor latência e podem tolerar mensagens perdidas ocasionais.

Se exactlyOnce for definido para true, as mensagens devem ser duradouras.
exatamenteUma vez Um Booleano que especifica se as mensagens processadas por esta ligação serão recebidas exatamente uma vez. A predefinição é true.

Uma mensagem pode ser enviada com ou sem garantias. Uma garantia permite a uma aplicação garantir que uma mensagem enviada chegou à fila de mensagens recetoras ou, se não o fez, a aplicação pode determinar isso lendo a fila de cartas mortas.

exactlyOnce, quando definido como true, indica que o MSMQ garantirá que uma mensagem enviada é entregue à fila de mensagens recetora uma única vez, e se a entrega falhar, a mensagem é enviada para a fila de cartas mortas.

As mensagens enviadas com exactlyOnce definido para true devem ser enviadas apenas para uma fila transacional.
Manual Endereçamento Um valor booleano que permite ao utilizador assumir o controlo do endereçamento da mensagem. Esta propriedade é geralmente usada em cenários de router, onde a aplicação determina para qual dos vários destinos enviar uma mensagem.

Quando definido para true, o canal assume que a mensagem já foi endereçada e não acrescenta qualquer informação adicional a ela. O utilizador pode então endereçar cada mensagem individualmente.

Quando definido para false, o mecanismo de endereçamento padrão da Windows Communication Foundation (WCF) cria automaticamente endereços para todas as mensagens.

A predefinição é false.
maxBufferPoolSize Um inteiro positivo que especifica o tamanho máximo do pool de buffer. O padrão é 524288.

Muitas partes do WCF usam buffers. Criar e destruir buffers sempre que são usados é caro, e a recolha de lixo para buffers também é dispendiosa. Com os buffer pools, podes pegar num buffer do pool, usá-lo e devolvê-lo ao pool quando terminares. Assim, evita-se a sobrecarga na criação e destruição de tampões.
maxRetentativas Imediatas Um inteiro que especifica o número máximo de tentativas imediatas de retentativa numa mensagem lida da fila da aplicação. A predefinição é 5.

Se for tentado o número máximo de tentativas imediatas para a mensagem e a mensagem não for consumida pela aplicação, então a mensagem é enviada para uma fila de retentativas para tentativa novamente num momento posterior. Se não forem especificados ciclos de retentativa, então a mensagem é enviada para a fila de mensagens envenenada, ou um reconhecimento negativo é enviado de volta ao remetente.
maxReceivedMessageSize Um inteiro positivo que especifica o tamanho máximo da mensagem em bytes, incluindo cabeçalhos. O remetente de uma mensagem recebe uma falha SOAP quando a mensagem é demasiado grande para o recetor. O recetor elimina a mensagem e cria uma entrada do evento no registo de rastreamento. O padrão é 65536.
maxRetryCycles Um inteiro que especifica o número máximo de ciclos de retentativa para tentar a entrega de mensagens à aplicação recetora. A predefinição é MaxValue.

Um único ciclo de tentativas tenta entregar uma mensagem a uma aplicação um número especificado de vezes. O número de tentativas feitas é definido pelo maxImmediateRetries atributo. Se a aplicação não conseguir consumir a mensagem depois de as tentativas de entrega terem sido esgotadas, a mensagem é enviada para uma fila de retentativa. Os ciclos de retentativas subsequentes consistem em a mensagem ser devolvida da fila de retentativas para a fila da aplicação para tentar a entrega novamente à aplicação, após um atraso especificado pelo retryCycleDelay atributo. O maxRetryCycles atributo especifica o número de ciclos de retentativa que a aplicação utiliza para tentar entregar a mensagem.
rejeiçãoDepoisÚltimoRetentativa Um valor booleano que especifica que ação tomar para uma mensagem que falhou na entrega após o número máximo de tentativas terem sido tentadas.

true significa que um reconhecimento negativo é devolvido ao remetente e a mensagem é descartada; false significa que a mensagem é enviada para a fila de mensagens do veneno. A predefinição é false.

Se o valor for false, a aplicação recetora pode ler a fila de mensagens de veneno para processar mensagens de veneno (ou seja, mensagens que falharam na entrega).

O MSMQ 3.0 não suporta devolver um reconhecimento negativo ao remetente, pelo que este atributo será ignorado no MSMQ 3.0.
retryCycleDelay A TimeSpan que especifica o atraso de tempo entre ciclos de retentativa ao tentar entregar uma mensagem que não pôde ser entregue imediatamente. O padrão é 00:10:00.

Um único ciclo de tentativa tenta entregar uma mensagem a uma aplicação recetora um número especificado de vezes. O número de tentativas feitas é especificado pelo maxImmediateRetries atributo. Se a aplicação não conseguir consumir a mensagem após o número especificado de tentativas imediatas, a mensagem é enviada para uma fila de retentativas. Os ciclos de retentativas subsequentes consistem em a mensagem ser devolvida da fila de retentativas para a fila da aplicação para tentar a entrega novamente à aplicação, após um atraso especificado pelo retryCycleDelay atributo. O número de ciclos de repetição é especificado por maxRetryCycles atributo.
serializationFormat Especifica o formateador usado para serializar objetos enviados como parte de uma mensagem MSMQ. Os valores válidos são

- ActiveX: O formateador ActiveX é usado ao serializar objetos COM.
- Binário: Serializa o objeto para um pacote binário.
- ByteArray: Serializa o objeto para um array de bytes.
- Fluxo: Serializa o objeto para um fluxo.
- Xml: Serializa o objeto para um pacote XML. O padrão é XML.

Este atributo é do tipo MsmqMessageSerializationFormat.
timeToLive A TimeSpan que especifica quanto tempo as mensagens são válidas antes de expirarem e serem colocadas na fila de letras mortas. O padrão é 1,00:00:00, o que significa 1 dia.

Este atributo é definido para garantir que as mensagens sensíveis ao tempo não se tornem obsoletas antes de serem processadas pelas aplicações recetoras. Uma mensagem numa fila que não é consumida pela aplicação recetora dentro do intervalo de tempo especificado é dita como expirada. As mensagens expiradas são enviadas para uma fila especial chamada fila de letras mortas. A localização da fila de letras mortas é definida com o customDeadLetterQueue atributo ou para o padrão apropriado, com base nas garantias.
useMsmqTracing Um valor booleano que especifica se as mensagens processadas por esta ligação devem ser rastreadas. A predefinição é false.

Quando o rastreio está ativado, as mensagens de relatório são criadas e enviadas para a fila de relatórios sempre que a mensagem sai ou chega a um computador de Fila de Mensagens.
useSourceJournal Um valor booleano que especifica se cópias de mensagens processadas por esta ligação devem ser armazenadas na fila de diário de origem. A predefinição é false.

Aplicações em fila que querem manter um registo das mensagens que saíram da fila de saída do computador podem copiar as mensagens para uma fila de diário. Quando uma mensagem sai da fila de saída e é recebido um reconhecimento de que a mensagem foi recebida no computador de destino, uma cópia da mensagem é mantida na fila de diário do sistema do computador emissor.

Elementos filho

Elemento Description
msmqTransportSecurity Especifica as definições de segurança de transporte para esta ligação. Este elemento é do tipo MsmqTransportSecurityElement.

Elementos Principais

Elemento Description
<Encadernação> Define todas as capacidades de ligação da ligação personalizada.

Consulte também

  • Last updated on