Message.UseDeadLetterQueue Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
Exceções
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.