Message.TimeToReachQueue Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает максимальное время, в течение которого сообщение должно дойти до очереди.
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, setPublic Property TimeToReachQueue As TimeSpanЗначение свойства
Лимит времени, отсчитываемый с момента отправки сообщения, в течение которого сообщение должно достичь очереди местоназначения. Значение по умолчанию — InfiniteTimeout.
- Атрибуты
Исключения
Очередь сообщений фильтруется, чтобы не учитывать свойство TimeToReachQueue.
Значение, указанное для TimeToReachQueue, недопустимо. Возможно, это отрицательное число.
Примеры
В следующем примере кода возвращается и задается значение свойства сообщения TimeToReachQueue .
Комментарии
Если срок действия интервала, указанного свойством TimeToReachQueue , истекает до того, как сообщение достигнет места назначения, очередь сообщений отклоняет сообщение одним из двух способов. Если свойство UseDeadLetterQueue сообщения имеет значение true, это сообщение будет передано в очередь недоставленных сообщений. Если UseDeadLetterQueue имеет значение false, сообщение игнорируется.
Вы можете задать свойство сообщения, чтобы служба очереди сообщений отправляла AcknowledgeType обратно в отправляющее приложение сообщение с отрицательным подтверждением, если сообщение не поступает до истечения срока действия таймера.
TimeToReachQueue Если для свойства задано значение 0 секунд, служба "Очередь сообщений" пытается один раз отправить сообщение в место назначения, если очередь ожидает сообщения. Если очередь является локальной, сообщение всегда достигает ее.
Если значение, указанное свойством TimeToReachQueue , больше значения, указанного свойством TimeToBeReceived , TimeToBeReceived имеет приоритет.
При отправке нескольких сообщений в одной транзакции очередь сообщений использует TimeToReachQueue свойство первого сообщения.
