MessageQueue.MaximumQueueSize-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Property MaximumQueueSize As Long
'Usage
Dim instance As MessageQueue
Dim value As Long

value = instance.MaximumQueueSize

instance.MaximumQueueSize = value

public long MaximumQueueSize { get; set; }

public:
property long long MaximumQueueSize {
    long long get ();
    void set (long long value);
}

/** @property */
public long get_MaximumQueueSize ()

/** @property */
public void set_MaximumQueueSize (long value)

public function get MaximumQueueSize () : long

public function set MaximumQueueSize (value : long)

Eigenschaftenwert

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

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die maximale Größe für die Warteschlange enthält einen negativen Wert.
MessageQueueException	Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

Die MaximumQueueSize ermöglicht einen Zugriff auf die Speicherplatzbegrenzung für Message Queuing-Meldungen. Dieser Wert ist unabhängig vom Meldungskontingent des Computers, das vom Administrator festgelegt wird. Weitere Informationen zum Meldungskontingent finden Sie unter MaximumJournalSize.

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

Bei einem Versuch, die maximale Größe der Warteschlange oder das Meldungskontingent des Computers zu überschreiten, können Meldungen verloren gehen. Wenn das Kontingent für die Warteschlange erreicht ist, benachrichtigt Message Queuing die Verwaltungswarteschlange der sendenden Anwendung durch eine negative Bestätigungsmeldung. Message Queuing sendet so lange negative Bestätigungen, bis die Gesamtgröße der Meldungen in der Warteschlange wieder unterhalb des Grenzwerts liegt.

Der folgenden Tabelle können Sie entnehmen, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Lokaler Computer + direkter Formatname	Ja
Remotecomputer	Nein
Lokaler Computer + direkter Formatname	Nein

Beispiel

Im folgenden Codebeispiel wird der Wert der MaximumQueueSize-Eigenschaft einer Meldungswarteschlange 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);

// Set the queue's MaximumQueueSize property value.
queue.set_MaximumQueueSize(10);
// Display the new value of the queue's MaximumQueueSize property.
Console.WriteLine("MessageQueue.MaximumQueueSize: {0}", 
    System.Convert.ToString(queue.get_MaximumQueueSize()));

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

MessageQueue-Klasse
MessageQueue-Member
System.Messaging-Namespace
MessageQueue.MaximumJournalSize-Eigenschaft
InfiniteQueueSize

Freigeben über