Partilhar via


Message.UseDeadLetterQueue Propriedade

Definição

Obtém ou define um valor que indica se uma cópia da mensagem que não pôde ser entregue deve ser enviada para 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 resultar em uma cópia da mensagem que está 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 UseDeadLetterQueue propriedade.

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 as UseDeadLetterQueue propriedades especificam como o Enfileiramento de Mensagens rastreia uma mensagem. Se UseDeadLetterQueue for true, falha de entrega (de uma mensagem não transacional), faz 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 por um temporizador de mensagem expirando, 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 uma fila de mensagens mortas. Essas são as filas do sistema geradas pelo Enfileiramento de Mensagens.

Aplica-se a

Confira também