Message.TimeToReachQueue Свойство

Определение

Получает или задает максимальное время, в течение которого сообщение должно дойти до очереди.Gets or sets the maximum amount of time for the message to reach the queue.

public:
 property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
public TimeSpan TimeToReachQueue { get; set; }
member this.TimeToReachQueue : TimeSpan with get, set
Public Property TimeToReachQueue As TimeSpan

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

Лимит времени, отсчитываемый с момента отправки сообщения, в течение которого сообщение должно достичь очереди местоназначения.The time limit for the message to reach the destination queue, beginning from the time the message is sent. Значение по умолчанию — InfiniteTimeout.The default is InfiniteTimeout.

Атрибуты

Исключения

Очередь сообщений фильтруется, чтобы не учитывать свойство TimeToReachQueue.The message queue is filtered to ignore the TimeToReachQueue property.

Задано недопустимое значение для TimeToReachQueue.The value specified for TimeToReachQueue is invalid. Возможно, это отрицательное число.It might represent a negative number.

Примеры

В следующем примере кода получается и задается значение TimeToReachQueue свойства сообщения.The following code example gets and sets the value of a message's TimeToReachQueue property.

Комментарии

Если интервал времени, заданный TimeToReachQueue свойством, истекает до того, как сообщение достигнет места назначения, очередь сообщений отклоняет сообщение одним из двух способов.If the interval specified by the TimeToReachQueue property expires before the message reaches its destination, Message Queuing discards the message in one of two ways. Если свойство UseDeadLetterQueue сообщения имеет значение true, это сообщение будет передано в очередь недоставленных сообщений.If the message's UseDeadLetterQueue property is true, the message is sent to the dead-letter queue. Если UseDeadLetterQueue параметр falseимеет значение, сообщение игнорируется.If UseDeadLetterQueue is false, the message is ignored

Можно задать для AcknowledgeType свойства сообщения значение запросить, чтобы служба очереди сообщений отправляла сообщение об отрицательном подтверждении обратно в приложение, если оно не поступает до истечения срока действия таймера.You can set he message's AcknowledgeType property to request that Message Queuing send a negative acknowledgment message back to the sending application if the message does not arrive before the timer expires.

TimeToReachQueue Если свойство имеет значение 0 секунд, служба очереди сообщений пытается отправить сообщение адресату, если очередь ожидает сообщения.If the TimeToReachQueue property is set to 0 seconds, Message Queuing tries once to send the message to its destination - if the queue is waiting for the message. Если очередь является локальной, сообщение всегда достигает этого сообщения.If the queue is local, the message always reaches it.

Если значение, заданное TimeToReachQueue свойством, больше значения, заданного TimeToBeReceived свойством, TimeToBeReceived приоритет получает.If the value specified by the TimeToReachQueue property is greater than the value specified by the TimeToBeReceived property, TimeToBeReceived takes precedence.

При отправке нескольких сообщений в одной транзакции очередь сообщений использует TimeToReachQueue свойство первого сообщения.When several messages are sent in a single transaction, Message Queuing uses the TimeToReachQueue property of the first message.

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

Дополнительно