MessageQueue.MaximumQueueSize Propriété

  • Référence

Définition

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

Obtient ou définit la taille maximale de la file d'attente.

public:
 property long MaximumQueueSize { long get(); void set(long value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.SizeConverter))]
[System.Messaging.MessagingDescription("MQ_MaximumQueueSize")]
public long MaximumQueueSize { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.SizeConverter))>]
[<System.Messaging.MessagingDescription("MQ_MaximumQueueSize")>]
member this.MaximumQueueSize : int64 with get, set
Public Property MaximumQueueSize As Long

Valeur de propriété

Int64

Taille maximale de la file d'attente, en kilo-octets. La valeur par défaut Message Queuing spécifie qu'il n'existe aucune limite.

Attributs
TypeConverterAttribute MessagingDescriptionAttribute

Exceptions

ArgumentException

La taille maximale de la file d'attente contient une valeur négative.

MessageQueueException

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

Exemples

L’exemple de code suivant obtient et définit la valeur de la propriété d’une file d’attente de MaximumQueueSize messages.

// Set the queue's MaximumQueueSize property value.
queue.MaximumQueueSize = 10;

// Display the new value of the queue's MaximumQueueSize property.
Console.WriteLine("MessageQueue.MaximumQueueSize: {0}",
    queue.MaximumQueueSize);

Remarques

fournit MaximumQueueSize l’accès à la limite de stockage des messages Message Queuing, qui est distincte du quota de messages de l’ordinateur défini par l’administrateur. Pour plus d’informations sur le quota de messages, consultez MaximumJournalSize.

La définition de cette propriété modifie la file d’attente Message Queuing. Par conséquent, toutes les autres MessageQueue instances sont affectées par la modification

Si une tentative est effectuée pour dépasser la taille maximale de la file d’attente ou le quota de messages de l’ordinateur, les messages peuvent être perdus. Lorsque le quota de file d’attente est atteint, Message Queuing avertit la file d’attente d’administration de l’application émettrice pour indiquer que la file d’attente est pleine, en retournant un message d’accusé de réception négatif. Message Queuing continue d’envoyer des accusés de réception négatifs jusqu’à ce que la taille totale des messages dans la file d’attente passe en dessous de la limite.

Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.

Mode groupe de travail Disponible
Ordinateur local Oui
Ordinateur local et nom de format direct Oui
Ordinateur distant Non
Ordinateur distant et nom de format direct Non

S’applique à

Voir aussi