Message.UseJournalQueue-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob eine Kopie der Meldung in einem Journal auf dem sendenden Computer abgelegt werden soll, 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 Message
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 nach erfolgreicher Übermittlung an den nächsten Server eine Kopie der Meldung in einem Journal auf dem sendenden Computer abgelegt werden soll, andernfalls false. Der Standardwert ist false.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die UseJournalQueue-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

Hinweise

Mit der UseJournalQueue-Eigenschaft und der UseDeadLetterQueue-Eigenschaft wird die Meldungsverfolgung in Message Queuing festgelegt. Wenn UseJournalQueue auf true festgelegt ist, wird bei jeder Übertragungstation eine Kopie der Meldung im Journal des sendenden Computers abgelegt.

Die gesendete Meldung wird nur in die Journalwarteschlange kopiert, wenn sich die Zielwarteschlange auf einem Remotecomputer befindet. Wenn sich das Ziel auf dem lokalen Computer befindet, wird die Meldung direkt an die Warteschlange gesendet. Es gibt keine Zwischensstationen, für die ein Journal erforderlich ist.

Wenn Sie Meldungen in einer Journalwarteschlange speichern, leeren Sie die Warteschlange regelmäßig, um nicht mehr benötigte Meldungen zu entfernen. Meldungen in einer Journalwarteschlange vermindern das Kontingent des Computers, auf dem sich die Warteschlange befindet. (Das Kontingent des Computers wird vom Administrator festgelegt.)

Journalwarteschlangen und Dead Letter-Warteschlangen werden nicht vom Benutzer erstellt. Dies sind Systemwarteschlangen, die von Message Queuing generiert werden.

Beispiel

Im folgenden Codebeispiel wird der Wert der UseJournalQueue-Eigenschaft einer Meldung abgerufen und festgelegt.

// Set the message's UseJournalQueue property.
orderMessage.UseJournalQueue = true;

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

// Set the message's UseJournalQueue property.
orderMessage->UseJournalQueue = true;

// Display the new value of the message's UseJournalQueue property.
Console::WriteLine("Message.UseJournalQueue: {0}",
    orderMessage->UseJournalQueue);

// Set the message's UseJournalQueue property.
orderMessage.set_UseJournalQueue(true);
// Display the new value of the message's UseJournalQueue property.
Console.WriteLine("Message.UseJournalQueue: {0}", 
    System.Convert.ToString(orderMessage.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

Message-Klasse
Message-Member
System.Messaging-Namespace
Message.UseDeadLetterQueue-Eigenschaft
UseTracing
MessageQueue.UseJournalQueue
MaximumJournalSize

Freigeben über