Partilhar via


Message.TimeToReachQueue Propriedade

Definição

Obtém ou define a quantidade máxima de tempo 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, set
Public Property TimeToReachQueue As TimeSpan

Valor da propriedade

O limite de tempo para a mensagem chegar à fila de destino, começando a partir do momento em que a mensagem é enviada. O padrão é InfiniteTimeout.

Atributos

Exceções

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

O valor especificado para TimeToReachQueue é inválido. Pode representar um número negativo.

Exemplos

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

Comentários

Se o intervalo especificado pela TimeToReachQueue propriedade expirar antes que a mensagem atinja seu destino, o Enfileiramento de Mensagens descartará a mensagem de uma das 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 chegar antes que o temporizador expire.

Se a TimeToReachQueue propriedade estiver definida como 0 segundos, o Enfileiramento de Mensagens tentará uma vez enviar a mensagem para seu destino – se a fila estiver aguardando a mensagem. Se a fila for local, a mensagem sempre a atingirá.

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

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

Aplica-se a

Confira também