DefaultPropertiesToSend.TimeToBeReceived Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

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 da propriedade

TimeSpan

O tempo total, em segundos, para que uma mensagem enviada seja recebida da fila de destino. O padrão é InfiniteTimeout.

Atributos

TypeConverterAttribute MessagingDescriptionAttribute

Comentários

A TimeToBeReceived propriedade especifica o tempo total em segundos para que uma mensagem enviada seja recebida da fila de destino. Esse limite de tempo inclui o tempo gasto para chegar à fila de destino, além do tempo gasto aguardando na fila antes que a mensagem seja recuperada por um aplicativo.

Cuidado

Ao usar computadores cliente dependentes, sincronize o relógio no computador cliente com o relógio no servidor que executa o Enfileiramento de Mensagens. Se os dois relógios não estiverem sincronizados, você poderá ver um comportamento imprevisível ao enviar mensagens quando TimeToBeReceived não InfiniteTimeoutfor .

Se o TimeToBeReceived intervalo expirar antes que a mensagem seja removida da fila, o aplicativo Enfileiramento de Mensagens descartará a mensagem. A mensagem será enviada para a fila de mensagens mortas, se a propriedade da UseDeadLetterQueue mensagem estiver definida truecomo ou ignorada, se UseDeadLetterQueue for false. Se TimeToBeReceived for menor que TimeToReachQueue, TimeToBeReceived terá precedência.

A propriedade da AcknowledgeType mensagem pode ser definida 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.

Cuidado

Se você especificou para receber TimeToReachQueue confirmações negativas, não as receberá quando o valor de TimeToBeReceived for menor que o valor de TimeToReachQueue.

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

Confira também

• TimeToReachQueue
• InfiniteTimeout
• TimeToBeReceived