Message.TimeToReachQueue 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 a mensagem chegar à fila.
public:
property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
public TimeSpan TimeToReachQueue { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, setPublic Property TimeToReachQueue As TimeSpanValor de Propriedade
O limite de tempo para a mensagem chegar à fila de destino, começando a partir do momento em que a mensagem é enviada. A predefinição é InfiniteTimeout.
- Atributos
Exceções
A fila de mensagens é filtrada para ignorar a TimeToReachQueue propriedade.
O valor especificado para TimeToReachQueue é inválido. Pode representar um número negativo.
Exemplos
O seguinte exemplo de código obtém e define o valor da TimeToReachQueue propriedade de uma mensagem.
Observações
Se o intervalo especificado pela TimeToReachQueue propriedade expirar antes da mensagem chegar ao destino, 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 de envio se a mensagem não chegar antes do temporizador expirar.
Se a TimeToReachQueue propriedade estiver definida para 0 segundos, a Fila de Mensagens tenta uma vez enviar a mensagem para o seu destino – se a fila estiver à espera da mensagem. Se a fila for local, a mensagem chega sempre até lá.
Se o valor especificado pela TimeToReachQueue propriedade for superior ao valor especificado pela TimeToBeReceived propriedade, TimeToBeReceived tem precedência.
Quando várias mensagens são enviadas numa única transação, a Fila de Mensagens utiliza a TimeToReachQueue propriedade da primeira mensagem.
