Message.TimeToBeReceived Свойство

Определение

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

System.Messaging

Сборка:

System.Messaging.dll

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

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, set

Public Property TimeToBeReceived As TimeSpan

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

TimeSpan

Общее время получения сообщения из конечной очереди. Значение по умолчанию — InfiniteTimeout.

Атрибуты

TypeConverterAttribute MessagingDescriptionAttribute

Исключения

InvalidOperationException

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

ArgumentException

Значение, указанное для TimeToBeReceived недопустимого.

Примеры

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

Комментарии

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

Предостережение

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

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

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

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

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

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

• TimeToReachQueue
• InfiniteTimeout