Message.TimeToBeReceived Propriedade

Definição

Obtém ou define a quantidade máxima de tempo para a mensagem a ser recebida da fila de destino.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.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
public TimeSpan TimeToBeReceived { get; set; }
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
[System.ComponentModel.TypeConverter(typeof(System.Messaging.TimeoutConverter))]
public TimeSpan TimeToBeReceived { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
member this.TimeToBeReceived : TimeSpan with get, set
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.TimeoutConverter))>]
member this.TimeToBeReceived : TimeSpan with get, set
Public Property TimeToBeReceived As TimeSpan

Valor da propriedade

TimeSpan

O tempo total para uma mensagem enviada ser recebida da fila de destino.The total time for a sent message to be received from the destination queue. O padrão é InfiniteTimeout.The default is InfiniteTimeout.

Atributos

Exceções

A fila de mensagens é filtrada para ignorar a propriedade TimeToBeReceived.The message queue is filtered to ignore the TimeToBeReceived property.

O valor especificado para TimeToBeReceived é inválido.The value specified for TimeToBeReceived is invalid.

Exemplos

O exemplo de código a seguir obtém e define o valor da propriedade de uma mensagem TimeToBeReceived .The following code example gets and sets the value of a message's TimeToBeReceived property.

Comentários

A TimeToBeReceived propriedade especifica o tempo total para que uma mensagem enviada seja recebida da fila de destino.The TimeToBeReceived property specifies the total time for a sent message to be received from the destination queue. O limite de tempo inclui o tempo gasto na obtenção da fila de destino e o tempo gasto aguardando na fila antes que a mensagem seja recebida.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.

Cuidado

Ao usar computadores cliente dependentes, verifique se o relógio no computador cliente está sincronizado com o relógio no servidor que está executando o enfileiramento de mensagens.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. Caso contrário, pode ocorrer um comportamento imprevisível ao enviar uma mensagem cuja TimeToBeReceived propriedade não seja InfiniteTimeout .Otherwise, unpredictable behavior might result when sending a message whose TimeToBeReceived property is not InfiniteTimeout.

Se o intervalo especificado pela TimeToBeReceived Propriedade expirar antes que a mensagem seja removida da fila, o serviço de enfileiramento de mensagens descartará a mensagem de uma das duas maneiras.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. Se a propriedade da mensagem UseDeadLetterQueue for true , a mensagem será enviada para a fila de mensagens mortas.If the message's UseDeadLetterQueue property is true, the message is sent to the dead-letter queue. Se UseDeadLetterQueue for false , a mensagem será ignorada.If UseDeadLetterQueue is false, the message is ignored.

Você pode definir a propriedade da mensagem AcknowledgeType para solicitar que o serviço de enfileiramento de mensagens envie uma mensagem de confirmação negativa de volta para o aplicativo de envio se a mensagem não for recuperada antes de o temporizador expirar.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.

Se o valor especificado pela TimeToBeReceived propriedade for menor que o valor especificado pela TimeToReachQueue propriedade, TimeToBeReceived terá precedência.If the value specified by the TimeToBeReceived property is less than the value specified by the TimeToReachQueue property, TimeToBeReceived takes precedence.

Quando várias mensagens são enviadas em uma única transação, o enfileiramento de mensagens usa a TimeToBeReceived propriedade da primeira mensagem.When several messages are sent in a single transaction, Message Queuing uses the TimeToBeReceived property of the first message.

Aplica-se a

Confira também