Message.TimeToBeReceived Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o tempo máximo para que a mensagem seja 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, setPublic Property TimeToBeReceived As TimeSpanValor de Propriedade
O tempo total para receber uma mensagem enviada da fila de destino. A predefinição é InfiniteTimeout.
- Atributos
Exceções
A fila de mensagens é filtrada para ignorar a TimeToBeReceived propriedade.
O valor especificado para TimeToBeReceived é inválido.
Exemplos
O seguinte exemplo de código obtém e define o valor da TimeToBeReceived propriedade de uma mensagem.
Observações
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 a chegar à fila de destino e o tempo a esperar na fila antes de a mensagem ser recebida.
Atenção
Ao utilizar computadores clientes dependentes, certifique-se de que o relógio do computador cliente está sincronizado com o relógio do servidor que está a executar a Mensagem em Fila. Caso contrário, pode resultar um comportamento imprevisível ao enviar uma mensagem cuja TimeToBeReceived propriedade não InfiniteTimeouté .
Se o intervalo especificado pela TimeToBeReceived propriedade expirar antes de a mensagem ser removida da fila, a Fila de Mensagens descarta a mensagem de duas formas. Se a propriedade da UseDeadLetterQueue mensagem for true, a mensagem é enviada para a fila de letras mortas. Se UseDeadLetterQueue for false, a mensagem é ignorada.
Pode definir a propriedade da AcknowledgeType mensagem para pedir que a Fila de Mensagens envie uma mensagem de confirmação negativa de volta à aplicação remetente se a mensagem não for recuperada antes do temporizador expirar.
Se o valor especificado pela TimeToBeReceived propriedade for inferior ao valor especificado pela TimeToReachQueue propriedade, TimeToBeReceived tem precedência.
Quando várias mensagens são enviadas numa única transação, a Fila de Mensagens utiliza a TimeToBeReceived propriedade da primeira mensagem.
