MessageQueue.UseJournalQueue-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob abgerufene Meldungen in die Journalwarteschlange kopiert werden, oder legt diesen fest.

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

Syntax

'Declaration
Public Property UseJournalQueue As Boolean
'Usage
Dim instance As MessageQueue
Dim value As Boolean

value = instance.UseJournalQueue

instance.UseJournalQueue = value

public bool UseJournalQueue { get; set; }

public:
property bool UseJournalQueue {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_UseJournalQueue ()

/** @property */
public void set_UseJournalQueue (boolean value)

public function get UseJournalQueue () : boolean

public function set UseJournalQueue (value : boolean)

Eigenschaftenwert

true, wenn aus der Warteschlange empfangene Meldungen in die Journalwarteschlange kopiert werden, andernfalls false.

Ausnahmen

Ausnahmetyp	Bedingung
MessageQueueException	Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

Wenn die Message Queuing-Anwendung eine neue Anwendungswarteschlange erstellt, erstellt sie an demselben Ort automatisch eine zugeordnete Journalwarteschlange. In der Journalwarteschlange werden die aus einer Warteschlange entfernten Meldungen verfolgt. Durch Festlegen dieser Eigenschaft wird die Message Queuing-Warteschlange geändert. Daher sind alle anderen MessageQueue-Instanzen ebenfalls von dieser Änderung betroffen.

Die Journalwarteschlange protokolliert weder Meldungen, die aus der Warteschlange entfernt wurden, weil deren maximale Verweilzeit in der Warteschlange abgelaufen war, noch Meldungen, die über einen Message Queuing-Verzeichnisdienst (Informationsspeicher oder Active Directory) permanent aus der Warteschlange gelöscht wurden.

Anwendungen können keine Meldungen an Journalwarteschlangen senden. Sie haben auf diese Warteschlagen ausschließlich Lesezugriff. Außerdem entfernt Message Queuing keine Meldungen aus Journalwarteschlangen. Die Anwendung, die die Warteschlange verwendet, muss die Meldungen entweder durch Abrufen der Meldung oder durch Löschen der Warteschlange löschen.

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 UseJournalQueue-Eigenschaft einer Meldungswarteschlange abgerufen und festgelegt.

// Set the queue's UseJournalQueue property value.
queue.UseJournalQueue = true;

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

// Set the queue's UseJournalQueue property value.
queue.set_UseJournalQueue(true);
// Display the new value of the queue's UseJournalQueue property.
Console.WriteLine("MessageQueue.UseJournalQueue: {0}", 
    System.Convert.ToString(queue.get_UseJournalQueue()));

.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

Freigeben über