Message.UseDeadLetterQueue Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, указывающее, должна ли копия сообщения, которое не может быть доставлено, передаваться в очередь недоставленных сообщений.
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
Значение свойства
Значение true
, если при сбое доставки сообщения его копия направляется в очередь недоставленных сообщений; в противном случае — значение false
. Значение по умолчанию — false
.
- Атрибуты
Исключения
Очередь сообщений фильтруется, чтобы не учитывать свойство UseDeadLetterQueue.
Примеры
В следующем примере кода возвращается и задается значение свойства сообщения UseDeadLetterQueue .
Комментарии
Свойства UseJournalQueue и UseDeadLetterQueue определяют способ отслеживания сообщения в очереди сообщений. Если UseDeadLetterQueue имеет значение true
, сбой доставки (сообщения, не относящееся к транзакциям), приводит к отправке сообщения в очередь недоставленных сообщений на компьютере, на котором не удалось доставить сообщение. Сбой доставки может быть вызван, например, истечением срока действия таймера сообщения.
В случае сбоя доставки транзакционного сообщения очередь сообщений отправляет сообщение в очередь недоставленных сообщений транзакций на исходном компьютере во всех отрицательных и сомнительных случаях.
При хранении сообщений в очереди недоставленных сообщений следует периодически очищать очередь, чтобы удалять ненужные сообщения. Сообщения, хранящиеся в очередях недоставленных сообщений, учитываются в квоте размера для компьютера, на котором находится очередь. Квота компьютера устанавливается администратором и относится к размеру, выделенному для хранения сообщений на всем компьютере, а не только в одной очереди.
Вы не создаете журнал или очередь недоставленных сообщений. Это обе системные очереди, создаваемые очередью сообщений.