Message.TimeToReachQueue-Eigenschaft

Artikel
08/20/2007

Ruft die Zeitbegrenzung der Meldung für das Erreichen der Warteschlange ab oder legt diese fest.

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

Syntax

'Declaration
Public Property TimeToReachQueue As TimeSpan
'Usage
Dim instance As Message
Dim value As TimeSpan

value = instance.TimeToReachQueue

instance.TimeToReachQueue = value

public TimeSpan TimeToReachQueue { get; set; }

public:
property TimeSpan TimeToReachQueue {
    TimeSpan get ();
    void set (TimeSpan value);
}

/** @property */
public TimeSpan get_TimeToReachQueue ()

/** @property */
public void set_TimeToReachQueue (TimeSpan value)

public function get TimeToReachQueue () : TimeSpan

public function set TimeToReachQueue (value : TimeSpan)

Eigenschaftenwert

Die maximale Dauer vom Senden der Meldung bis zum Erreichen der Zielwarteschlange. Der Standardwert ist InfiniteTimeout.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die TimeToReachQueue-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
ArgumentException	Der für TimeToReachQueue angegebene Wert ist ungültig. Eventuell wurde ein negativer Wert angegeben.

Hinweise

Wenn die in der TimeToReachQueue-Eigenschaft angegebene Zeitspanne abläuft, bevor die Meldung das Ziel erreicht hat, verwirft Message Queuing die Meldung unter Berücksichtigung der folgenden Einstellungen. Wenn die UseDeadLetterQueue-Eigenschaft auf true festgelegt ist, wird die Meldung an die Dead Letter-Warteschlange gesendet. Wenn UseDeadLetterQueue auf false festgelegt ist, wird die Meldung ignoriert.

Durch Festlegen der AcknowledgeType-Eigenschaft der Meldung kann Message Queuing aufgefordert werden, eine negative Bestätigungsmeldung an die sendende Anwendung zurückzusenden, wenn die Meldung ihr Ziel nicht vor Ablauf der Zeitspanne erreicht.

Wenn die TimeToReachQueue-Eigenschaft auf 0 Sekunden festgelegt ist und die Warteschlange eingehende Meldungen empfängt, versucht Message Queuing einmal, die Meldung an den Bestimmungsort zu senden. Wenn die Warteschlange lokal ist, erreicht die Meldung immer die Warteschlange.

Wenn der Wert der TimeToReachQueue-Eigenschaft größer als der Wert der TimeToBeReceived-Eigenschaft ist, hat TimeToBeReceived Vorrang.

Wenn innerhalb einer einzelnen Transaktion mehrere Meldungen gesendet werden, verwendet Message Queuing den in der ersten Meldung angegebenen Wert für die TimeToReachQueue-Eigenschaft.

Beispiel

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

// Set the message's TimeToReachQueue property to five minutes.
orderMessage.TimeToReachQueue = TimeSpan.FromMinutes(5.0);

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

// Set the message's TimeToReachQueue property to five minutes.
orderMessage->TimeToReachQueue = TimeSpan::FromMinutes(5.0);

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

// Set the message's TimeToReachQueue property to five minutes.
orderMessage.set_TimeToReachQueue(TimeSpan.FromMinutes(5.0));
// Display the new value of the message's TimeToReachQueue property.
Console.WriteLine("Message.TimeToReachQueue: {0}", 
    orderMessage.get_TimeToReachQueue().ToString());

.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.TimeToBeReceived-Eigenschaft
InfiniteTimeout

Freigeben über