Message.TimeToBeReceived Propriété

  • Référence

Définition

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

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é

TimeSpan

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
TypeConverterAttribute MessagingDescriptionAttribute

Exceptions

InvalidOperationException

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

ArgumentException

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 d’attente 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 sur 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 est 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 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 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