Message.TimeToBeReceived Message.TimeToBeReceived Message.TimeToBeReceived Message.TimeToBeReceived Property

Определение

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

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

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

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

Исключения

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

Задано недопустимое значение для TimeToBeReceived.The value specified for TimeToBeReceived is invalid.

Примеры

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

Комментарии

TimeToBeReceived Свойство указывает общее время, когда отправленное сообщение должно быть получено из очереди назначения.The TimeToBeReceived property specifies the total time for a sent message to be received from the destination queue. Ограничение времени включает время, затраченное на получение очереди назначения, и время, затраченное на ожидание в очереди до получения сообщения.The time limit includes the time spent getting to the destination queue and the time spent waiting in the queue before the message is received.

Внимание!

При использовании зависимых клиентских компьютеров убедитесь, что часы на клиентском компьютере синхронизированы с часами на сервере, на котором запущена служба очереди сообщений.When using dependent client computers, be sure the clock on the client computer is synchronized with the clock on the server that is running Message Queuing. В противном случае непредсказуемое поведение может возникать при отправке сообщения, InfiniteTimeoutсвойство которого TimeToBeReceived не имеет значение.Otherwise, unpredictable behavior might result when sending a message whose TimeToBeReceived property is not InfiniteTimeout.

Если интервал, заданный TimeToBeReceived свойством, истечет до удаления сообщения из очереди, очередь сообщений отбрасывает сообщение одним из двух способов.If the interval specified by the TimeToBeReceived property expires before the message is removed from the queue, 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 the message's AcknowledgeType property to request that Message Queuing send a negative acknowledgment message back to the sending application if the message is not retrieved before the timer expires.

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

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

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

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