Message.TimeToReachQueue 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 atteindre la file d’attente.
public:
property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
public TimeSpan TimeToReachQueue { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, set
Public Property TimeToReachQueue As TimeSpan
Valeur de propriété
Limite de temps pour que le message atteigne la file d’attente de destination, à compter du moment où le message est envoyé. La valeur par défaut est InfiniteTimeout.
- Attributs
Exceptions
La file d’attente de messages est filtrée pour ignorer la TimeToReachQueue propriété.
La valeur spécifiée pour TimeToReachQueue n’est pas valide. Il peut représenter un nombre négatif.
Exemples
L’exemple de code suivant obtient et définit la valeur de la propriété d’un TimeToReachQueue message.
Remarques
Si l’intervalle spécifié par la TimeToReachQueue propriété expire avant que le message atteigne sa destination, 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’arrive pas avant l’expiration du minuteur.
Si la TimeToReachQueue propriété est définie sur 0 secondes, Message Queuing tente une fois d’envoyer le message à sa destination , si la file d’attente attend le message. Si la file d’attente est locale, le message l’atteint toujours.
Si la valeur spécifiée par la TimeToReachQueue propriété est supérieure à la valeur spécifiée par la TimeToBeReceived propriété, TimeToBeReceived est prioritaire.
Lorsque plusieurs messages sont envoyés dans une transaction unique, Message Queuing utilise la TimeToReachQueue propriété du premier message.