Message.TimeToBeReceived Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Zeitbegrenzung für den Empfang der Meldung aus der Zielwarteschlange ab oder legt diese fest.
public:
property TimeSpan TimeToBeReceived { TimeSpan get(); void set(TimeSpan value); };[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
public TimeSpan TimeToBeReceived { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
member this.TimeToBeReceived : TimeSpan with get, setPublic Property TimeToBeReceived As TimeSpanEigenschaftswert
Die für eine gesendete Meldung vorgegebene Gesamtzeit bis zum Empfang aus der Zielwarteschlange. Der Standardwert ist InfiniteTimeout.
- Attribute
Ausnahmen
Die TimeToBeReceived-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
Der für TimeToBeReceived angegebene Wert ist ungültig.
Beispiele
Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachricht TimeToBeReceived abgerufen und festgelegt.
Hinweise
Die TimeToBeReceived -Eigenschaft gibt die Gesamtzeit für eine gesendete Nachricht an, die von der Zielwarteschlange empfangen werden soll. Das Zeitlimit umfasst die Zeit, die für den Zugriff auf die Zielwarteschlange aufgewendet wird, und die Wartezeit in der Warteschlange, bevor die Nachricht empfangen wird.
Achtung
Stellen Sie bei Verwendung abhängiger Clientcomputer sicher, dass die Uhr auf dem Clientcomputer mit der Uhr auf dem Server synchronisiert ist, auf dem Message Queuing ausgeführt wird. Andernfalls kann beim Senden einer Nachricht, deren TimeToBeReceived Eigenschaft nicht InfiniteTimeoutist, unvorhersehbares Verhalten auftreten.
Wenn das durch die TimeToBeReceived -Eigenschaft angegebene Intervall abläuft, bevor die Nachricht aus der Warteschlange entfernt wird, verwirft Message Queuing die Nachricht auf eine von zwei Arten. Wenn die UseDeadLetterQueue-Eigenschaft auf true festgelegt ist, wird die Nachricht an die Dead Letter-Warteschlange gesendet. Wenn UseDeadLetterQueue ist false, wird die Nachricht ignoriert.
Sie können die Eigenschaft der Nachricht so festlegen, dass Message Queuing eine negative Bestätigungsnachricht AcknowledgeType zurück an die sendende Anwendung sendet, wenn die Nachricht nicht abgerufen wird, bevor der Timer abläuft.
Wenn der durch die TimeToBeReceived -Eigenschaft angegebene Wert kleiner als der von der TimeToReachQueue -Eigenschaft angegebene Wert ist, TimeToBeReceived hat Vorrang.
Wenn mehrere Nachrichten in einer einzelnen Transaktion gesendet werden, verwendet Message Queuing die TimeToBeReceived Eigenschaft der ersten Nachricht.
