Message.TimeToReachQueue Propriété

  • Référence

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

Obtient ou définit le délai accordé à un message pour 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é

TimeSpan

Le délai en secondes accordé au message pour atteindre la file d'attente de destination, à compter de l'heure d'envoi du message. La valeur par défaut est InfiniteTimeout.

Attributs
TypeConverterAttribute MessagingDescriptionAttribute

Exceptions

InvalidOperationException

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

ArgumentException

La valeur spécifiée pour TimeToReachQueue n'est pas valide. Il peut s'agir d'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 n’atteigne sa destination, Message Queuing ignore le message de deux façons. 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’arrive pas avant l’expiration du minuteur.

Si la TimeToReachQueue propriété est définie sur 0 seconde, 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 y parvient 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 seule transaction, Message Queuing utilise la TimeToReachQueue propriété du premier message.

S’applique à

Voir aussi