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 la durée maximale pendant laquelle le message doit être reçu 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é
Durée totale de réception d’un message envoyé à partir de la file d’attente de destination. La valeur par défaut est InfiniteTimeout.
- Attributs
Exceptions
La file d’attente de messages est filtrée pour ignorer la TimeToBeReceived propriété.
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 le temps total 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.
Avertissement
Lorsque vous utilisez des ordinateurs clients dépendants, assurez-vous que l’horloge sur l’ordinateur client est synchronisée avec l’horloge sur le serveur exécutant 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. Si la propriété du UseDeadLetterQueue message est true, le message est envoyé à la file d’attente de lettres mortes. Si UseDeadLetterQueue c’est falsele cas, 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 d’envoi 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 elle est prioritaire.
Lorsque plusieurs messages sont envoyés dans une transaction unique, Message Queuing utilise la TimeToBeReceived propriété du premier message.
