Freigeben über

MessageQueue.MaximumQueueSize Eigenschaft

Definition

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

Ruft die maximale Größe der Warteschlange ab oder legt sie 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 in Kilobyte der Warteschlange. Der Standardwert "Message Queuing" gibt an, dass kein Grenzwert vorhanden ist.

Attribute
TypeConverterAttribute MessagingDescriptionAttribute

Ausnahmen

ArgumentException

Die maximale Warteschlangengröße 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

Der MaximumQueueSize Zugriff auf den Nachrichtenspeichergrenzwert "Message Queuing" ist getrennt vom Nachrichtenkontingent des Computers, das der Administrator definiert. 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 möglicherweise Nachrichten 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.

In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokaler Computer Ja
Name des lokalen Computers und des direkten Formats Ja
Remotecomputer No
Name des Remotecomputers und des direkten Formats No

Gilt für:

Weitere Informationen