DefaultPropertiesToSend.TimeToBeReceived Propriedade

Definição

Obtém ou define o limite de tempo para a mensagem ser recuperada 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 de Propriedade

O tempo total, em segundos, para receber uma mensagem enviada da fila de destino. A predefinição é InfiniteTimeout.

Atributos

Observações

A TimeToBeReceived propriedade especifica o tempo total em segundos para que uma mensagem enviada seja recebida da fila de destino. Este limite de tempo inclui o tempo gasto a chegar à fila de destino, mais o tempo de espera na fila antes de a mensagem ser recuperada por uma aplicação.

Atenção

Ao utilizar computadores clientes dependentes, sincronize o relógio do computador cliente com o relógio do servidor que executa a Fila de Mensagens. Se os dois relógios não estiverem sincronizados, pode observar um comportamento imprevisível ao enviar mensagens quando TimeToBeReceived não InfiniteTimeouté .

Se o intervalo TimeToBeReceived expirar antes de a mensagem ser removida da fila, a aplicação de Fila de Mensagens descarta a mensagem. A mensagem é enviada para a fila de letras mortas, se a propriedade da UseDeadLetterQueue mensagem estiver definida para true, ou ignorada, se UseDeadLetterQueue for false. Se TimeToBeReceived for menor que TimeToReachQueue, TimeToBeReceived tem precedência.

A propriedade da AcknowledgeType mensagem pode ser definida 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 for recuperada antes do temporizador expirar.

Atenção

Se especificou receber TimeToReachQueue acusações negativas, não as receberá quando o valor de TimeToBeReceived for inferior ao valor de TimeToReachQueue.

Quando várias mensagens são enviadas numa transação, a Fila de Mensagens utiliza o valor da propriedade da TimeToBeReceived primeira mensagem.

Aplica-se a

Ver também