Compartilhar via


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.

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

Valor da propriedade

O tempo total para uma mensagem enviada ser recebida da fila de destino. O padrão é InfiniteTimeout.

Atributos

Exceções

A fila de mensagens é filtrada para ignorar a propriedade TimeToBeReceived.

O valor especificado para TimeToBeReceived é inválido.

Exemplos

O exemplo de código a seguir obtém e define o valor da propriedade de TimeToBeReceived uma mensagem.

Comentários

A TimeToBeReceived propriedade especifica o tempo total para que uma mensagem enviada seja recebida da fila de destino. O limite de tempo inclui o tempo gasto para chegar à fila de destino e o tempo gasto aguardando na fila antes que a mensagem seja recebida.

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. Caso contrário, um comportamento imprevisível pode resultar ao enviar uma mensagem cuja TimeToBeReceived propriedade não InfiniteTimeouté .

Se o intervalo especificado pela TimeToBeReceived propriedade expirar antes que a mensagem seja removida da fila, o Enfileiramento de Mensagens descartará a mensagem de duas maneiras. Se a propriedade da UseDeadLetterQueue mensagem for true, a mensagem será enviada para a fila de mensagens mortas. Se UseDeadLetterQueue for false, a mensagem será ignorada.

Você pode definir a propriedade da AcknowledgeType mensagem para solicitar que o 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 que o temporizador expire.

Se o valor especificado pela TimeToBeReceived propriedade for menor que o valor especificado pela TimeToReachQueue propriedade , TimeToBeReceived terá precedência.

Quando várias mensagens são enviadas em uma única transação, o Enfileiramento de Mensagens usa a TimeToBeReceived propriedade da primeira mensagem.

Aplica-se a

Confira também