Поделиться через


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

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

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

Применяется к

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