MessageQueue.MaximumQueueSize Eigenschaft

  • Referenz

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Ruft die maximale Größe der Warteschlange ab oder legt diese fest.

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

Eigenschaftswert

Int64

Die maximale Größe der Warteschlange in KB. In der Standardeinstellung von Message Queuing ist keine Begrenzung festgelegt.

Attribute
TypeConverterAttribute MessagingDescriptionAttribute

Ausnahmen

ArgumentException

Die maximale Größe für die Warteschlange enthält einen negativen Wert.

MessageQueueException

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachrichtenwarteschlange MaximumQueueSize abgerufen und festgelegt.

// 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);

Hinweise

Bietet MaximumQueueSize Zugriff auf das Message Queuing-Nachrichtenspeicherlimit, das vom Vom Administrator definierten Nachrichtenkontingent des Computers getrennt ist. Weitere Informationen zum Nachrichtenkontingent finden Sie unter MaximumJournalSize.

Durch Festlegen dieser Eigenschaft wird die Message Queuing-Warteschlange geändert. Daher sind alle anderen MessageQueue Instanzen von der Änderung betroffen.

Wenn versucht wird, entweder die maximale Warteschlangengröße oder das Computernachrichtenkontingent zu überschreiten, gehen Nachrichten möglicherweise verloren. Wenn das Warteschlangenkontingent erreicht ist, benachrichtigt Message Queuing die Verwaltungswarteschlange der sendenden Anwendung, um anzugeben, dass die Warteschlange voll ist, indem eine negative Bestätigungsmeldung zurückgegeben wird. Message Queuing sendet weiterhin negative Bestätigungen, bis die Gesamtgröße der Nachrichten in der Warteschlange unter den Grenzwert fällt.

Die folgende Tabelle zeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Name des lokalen Computers und des direkten Formats Ja
Remotecomputer Nein
Name des Remotecomputers und des direkten Formats Nein

Gilt für:

Weitere Informationen