Message.TimeToBeReceived-Eigenschaft

Artikel
08/20/2007

Ruft die Zeitbegrenzung für den Empfang der Meldung aus der Zielwarteschlange ab oder legt diese fest.

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

Syntax

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

value = instance.TimeToBeReceived

instance.TimeToBeReceived = value

public TimeSpan TimeToBeReceived { get; set; }

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

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

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

public function get TimeToBeReceived () : TimeSpan

public function set TimeToBeReceived (value : TimeSpan)

Eigenschaftenwert

Die für eine gesendete Meldung vorgegebene Gesamtzeit bis zum Empfang aus der Zielwarteschlange. Der Standardwert ist InfiniteTimeout.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die TimeToBeReceived-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
ArgumentException	Der für TimeToBeReceived angegebene Wert ist ungültig.

Hinweise

Die TimeToBeReceived-Eigenschaft gibt für eine gesendete Meldung die maximale Dauer bis zum Empfang aus der Zielwarteschlange an. Diese Zeitbegrenzung umfasst die Dauer bis zum Erreichen der Zielwarteschlange sowie die Wartezeit bis zum Abruf aus der Warteschlange.

Warnung

Synchronisieren Sie beim Einsatz von abhängigen Clientcomputern die Uhr auf dem Clientcomputer mit der Uhr des Servers, auf dem Message Queuing ausgeführt wird. Andernfalls ist das Verhalten für Meldungen nicht vorhersehbar, die mit einem anderen Wert als InfiniteTimeout für die TimeToBeReceived-Eigenschaft gesendet werden.

Wenn die in der TimeToBeReceived-Eigenschaft angegebene Zeitspanne abläuft, bevor die Meldung aus der Warteschlange entfernt wurde, 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 nicht vor Ablauf der Zeitspanne abgerufen wurde.

Wenn der Wert der TimeToBeReceived-Eigenschaft kleiner als der Wert der TimeToReachQueue-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 TimeToBeReceived-Eigenschaft.

Beispiel

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

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

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

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

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

// Set the message's TimeToBeReceived property to five minutes.
orderMessage.set_TimeToBeReceived(TimeSpan.FromMinutes(5.0));
// Display the new value of the message's TimeToBeReceived property.
Console.WriteLine("Message.TimeToBeReceived: {0}", 
    orderMessage.get_TimeToBeReceived().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
TimeToReachQueue
InfiniteTimeout

Freigeben über