Message.TimeToBeReceived Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает максимальное время, в течение которого сообщение должно быть извлечено из очереди местоназначения.
public:
property TimeSpan TimeToBeReceived { TimeSpan get(); void set(TimeSpan value); };[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
public TimeSpan TimeToBeReceived { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
member this.TimeToBeReceived : TimeSpan with get, setPublic Property TimeToBeReceived As TimeSpanЗначение свойства
Суммарное время, в течение которого переданное сообщение должно быть получено из очереди местоназначения. Значение по умолчанию — InfiniteTimeout.
- Атрибуты
Исключения
Очередь сообщений фильтруется, чтобы не учитывать свойство TimeToBeReceived.
Значение, указанное для TimeToBeReceived, недопустимо.
Примеры
В следующем примере кода получается и задается значение свойства сообщения TimeToBeReceived .
Комментарии
Свойство TimeToBeReceived указывает общее время получения отправленного сообщения из конечной очереди. Ограничение по времени включает время, затраченное на получение в целевую очередь, и время, затраченное на ожидание в очереди до получения сообщения.
Внимание!
При использовании зависимых клиентских компьютеров убедитесь, что часы на клиентском компьютере синхронизированы с часами на сервере, где выполняется очередь сообщений. В противном случае при отправке сообщения может возникнуть непредсказуемое поведение, свойство которого TimeToBeReceived не InfiniteTimeoutравно .
Если интервал, указанный TimeToBeReceived свойством , истекает до удаления сообщения из очереди, очередь сообщений удаляет сообщение одним из двух способов. Если свойство UseDeadLetterQueue сообщения имеет значение true, это сообщение будет передано в очередь недоставленных сообщений. Если UseDeadLetterQueue имеет значение false, сообщение игнорируется.
Вы можете задать свойство сообщения AcknowledgeType , чтобы запросить отправку сообщения message queuing обратно в отправляющее приложение, если сообщение не было получено до истечения срока действия таймера.
Если значение, указанное свойством TimeToBeReceived , меньше значения, указанного свойством TimeToReachQueue , TimeToBeReceived имеет приоритет.
При отправке нескольких сообщений в одной транзакции очередь сообщений использует TimeToBeReceived свойство первого сообщения.
