Message.TimeToBeReceived Propriété

Définition

Obtient ou définit le délai d'attente pour la réception du message à partir de la file d'attente de destination.

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

Valeur de propriété

La durée totale pour la réception d'un message à partir de la file d'attente de destination. La valeur par défaut est InfiniteTimeout.

Attributs

Exceptions

La file d'attente des messages est filtrée pour ignorer la propriété TimeToBeReceived.

La valeur spécifiée pour TimeToBeReceived n'est pas valide.

Exemples

L’exemple de code suivant obtient et définit la valeur de la propriété d’un TimeToBeReceived message.

Remarques

La TimeToBeReceived propriété spécifie la durée totale de réception d’un message envoyé à partir de la file d’attente de destination. La limite de temps inclut le temps passé à atteindre la file d’attente de destination et le temps passé à attendre dans la file d’attente avant la réception du message.

Attention

Lorsque vous utilisez des ordinateurs clients dépendants, assurez-vous que l’horloge de l’ordinateur client est synchronisée avec l’horloge sur le serveur qui exécute Message Queuing. Sinon, un comportement imprévisible peut se produire lors de l’envoi d’un message dont TimeToBeReceived la propriété n’est pas InfiniteTimeout.

Si l’intervalle spécifié par la TimeToBeReceived propriété expire avant que le message ne soit supprimé de la file d’attente, Message Queuing ignore le message de l’une des deux manières suivantes. Si la propriété du message UseDeadLetterQueue a la valeur true, le message est envoyé dans la file d'attente de lettres mortes. Si UseDeadLetterQueue a la valeur false, le message est ignoré.

Vous pouvez définir la propriété du AcknowledgeType message pour demander à Message Queuing d’envoyer un message d’accusé de réception négatif à l’application émettrice si le message n’est pas récupéré avant l’expiration du minuteur.

Si la valeur spécifiée par la TimeToBeReceived propriété est inférieure à la valeur spécifiée par la TimeToReachQueue propriété , TimeToBeReceived est prioritaire.

Lorsque plusieurs messages sont envoyés dans une seule transaction, Message Queuing utilise la TimeToBeReceived propriété du premier message.

S’applique à

Voir aussi