Message.UseDeadLetterQueue Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém ou define um valor que indica se uma cópia da mensagem que não pôde ser entregue deve ser enviada a uma fila de mensagens mortas.

public:
 property bool UseDeadLetterQueue { bool get(); void set(bool value); };

[System.Messaging.MessagingDescription("MsgUseDeadLetterQueue")]
public bool UseDeadLetterQueue { get; set; }

[<System.Messaging.MessagingDescription("MsgUseDeadLetterQueue")>]
member this.UseDeadLetterQueue : bool with get, set

Public Property UseDeadLetterQueue As Boolean

Valor da propriedade

Boolean

true se a falha na entrega de mensagens deve resultar em uma cópia da mensagem sendo enviada para uma fila de mensagens mortas; caso contrário, false. O padrão é false.

Atributos

MessagingDescriptionAttribute

Exceções

InvalidOperationException

A fila de mensagens é filtrada para ignorar a propriedade UseDeadLetterQueue.

Exemplos

O exemplo de código a seguir obtém e define o valor da propriedade de UseDeadLetterQueue uma mensagem.

Comentários

As UseJournalQueue propriedades e UseDeadLetterQueue especificam como o Enfileiramento de Mensagens rastreia uma mensagem. Se UseDeadLetterQueue for true, a falha de entrega (de uma mensagem não transacional) fará com que a mensagem seja enviada para a fila de mensagens mortas não transacionais no computador que não pôde entregar a mensagem. A falha de entrega pode ser causada pela expiração de um temporizador de mensagem, por exemplo.

No caso de falha de entrega de uma mensagem transacional, o Enfileiramento de Mensagens envia a mensagem para a fila de mensagens mortas transacionais no computador de origem em todos os casos negativos e em dúvida.

Ao armazenar mensagens em uma fila de mensagens mortas, você deve limpar a fila periodicamente para remover mensagens que não são mais necessárias. As mensagens armazenadas em filas de mensagens mortas contam com relação à cota de tamanho do computador em que a fila reside. A cota do computador é definida pelo administrador e refere-se ao tamanho alocado para armazenar mensagens em todo o computador, não apenas em uma única fila.

Você não cria um diário ou fila de mensagens mortas. Essas são as filas do sistema geradas pelo Enfileiramento de Mensagens.

Confira também

• UseJournalQueue
• UseTracing