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 , чтобы запросить отправку сообщения в очередь сообщений обратно в отправляющее приложение, если сообщение не получено до истечения срока действия таймера.

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

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

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

• TimeToReachQueue
• InfiniteTimeout