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