Message.TimeToBeReceived Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property TimeToBeReceived As TimeSpanValeur 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.
