Message.UseDeadLetterQueue Message.UseDeadLetterQueue Message.UseDeadLetterQueue Message.UseDeadLetterQueue Property

Определение

Получает или задает значение, указывающее, должна ли копия сообщения, которое не может быть доставлено, передаваться в очередь недоставленных сообщений.Gets or sets a value that indicates whether a copy of the message that could not be delivered should be sent to a dead-letter queue.

public:
 property bool UseDeadLetterQueue { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MsgUseDeadLetterQueue")]
public bool UseDeadLetterQueue { get; set; }
member this.UseDeadLetterQueue : bool with get, set
Public Property UseDeadLetterQueue As Boolean

Значение свойства

Значение true, если при сбое доставки сообщения его копия направляется в очередь недоставленных сообщений; в противном случае — значение false.true if message-delivery failure should result in a copy of the message being sent to a dead-letter queue; otherwise, false. Значение по умолчанию — false.The default is false.

Исключения

Очередь сообщений фильтруется, чтобы не учитывать свойство UseDeadLetterQueue.The message queue is filtered to ignore the UseDeadLetterQueue property.

Примеры

В следующем примере кода получается и задается значение UseDeadLetterQueue свойства сообщения.The following code example gets and sets the value of a message's UseDeadLetterQueue property.

Комментарии

Свойства UseJournalQueue иUseDeadLetterQueue определяют, каким способом служба очередей сообщений отслеживает сообщение.The UseJournalQueue and UseDeadLetterQueue properties specify how Message Queuing tracks a message. Если UseDeadLetterQueue имеет trueзначение, сбой доставки (нетранзакционного сообщения) приводит к тому, что сообщение отправляется в нетранзакционную очередь недоставленных сообщений на компьютере, который не может доставить сообщение.If UseDeadLetterQueue is true, delivery failure (of a non-transactional message), causes the message to be sent to the non-transactional dead-letter queue on the computer that could not deliver the message. Например, ошибка доставки может быть вызвана истечением срока действия таймера сообщения.Delivery failure could be caused by a message timer expiring, for example.

В случае сбоя доставки транзакционного сообщения очередь сообщений отправляет сообщение в очередь недоставленных транзактных сообщений на исходном компьютере во всех отрицательных и сомнительных случаях.In the case of delivery failure for a transactional message, Message Queuing sends the message to the transactional dead-letter queue on the source machine in all negative and in-doubt cases.

Если сообщения хранятся в очереди недоставленных сообщений, следует периодически очищать очередь, чтобы удалить сообщения, которые больше не нужны.When you store messages in a dead-letter queue, you should clear the queue periodically to remove messages that are no longer needed. Сообщения, хранящиеся в очередях недоставленных сообщений, засчитывается в соответствии с квотой на размер компьютера, на котором находится очередь.Messages stored in dead-letter queues count against the size quota for the computer where the queue resides. Квота компьютера задается администратором и относится к размеру, выделенному для хранения сообщений на целом компьютере, а не только в одной очереди.The computer quota is set by the administrator and refers to the size allocated for storing messages on the whole computer, not just in a single queue.

Не создается журнал или очередь недоставленных сообщений.You do not create a journal or dead-letter queue. Это Системные очереди, создаваемые очередью сообщений.These are both system queues that Message Queuing generates.

Применяется к

Дополнительно