Message.TimeToReachQueue Свойство

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Получает или задает максимальное время, в течение которого сообщение должно дойти до очереди.

public:
 property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };

[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
public TimeSpan TimeToReachQueue { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, set

Public Property TimeToReachQueue As TimeSpan

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

TimeSpan

Лимит времени, отсчитываемый с момента отправки сообщения, в течение которого сообщение должно достичь очереди местоназначения. Значение по умолчанию — InfiniteTimeout.

Атрибуты

TypeConverterAttribute MessagingDescriptionAttribute

Исключения

InvalidOperationException

Очередь сообщений фильтруется, чтобы не учитывать свойство TimeToReachQueue.

ArgumentException

Значение, указанное для TimeToReachQueue, недопустимо. Возможно, это отрицательное число.

Примеры

В следующем примере кода возвращается и задается значение свойства сообщения TimeToReachQueue .

Комментарии

Если срок действия интервала, указанного свойством TimeToReachQueue , истекает до того, как сообщение достигнет места назначения, очередь сообщений отклоняет сообщение одним из двух способов. Если свойство UseDeadLetterQueue сообщения имеет значение true, это сообщение будет передано в очередь недоставленных сообщений. Если UseDeadLetterQueue имеет значение false, сообщение игнорируется.

Вы можете задать свойство сообщения, чтобы служба очереди сообщений отправляла AcknowledgeType обратно в отправляющее приложение сообщение с отрицательным подтверждением, если сообщение не поступает до истечения срока действия таймера.

TimeToReachQueue Если для свойства задано значение 0 секунд, служба "Очередь сообщений" пытается один раз отправить сообщение в место назначения, если очередь ожидает сообщения. Если очередь является локальной, сообщение всегда достигает ее.

Если значение, указанное свойством TimeToReachQueue , больше значения, указанного свойством TimeToBeReceived , TimeToBeReceived имеет приоритет.

При отправке нескольких сообщений в одной транзакции очередь сообщений использует TimeToReachQueue свойство первого сообщения.

См. также раздел

• TimeToBeReceived
• InfiniteTimeout