Message.TimeToReachQueue 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.
Dient zum Abrufen oder Festlegen der maximalen Zeitdauer für die Nachricht, um die Warteschlange zu erreichen.
public:
property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
public TimeSpan TimeToReachQueue { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, setPublic Property TimeToReachQueue As TimeSpanEigenschaftswert
Das Zeitlimit für die Nachricht, um die Zielwarteschlange zu erreichen, beginnend mit dem Zeitpunkt, zu dem die Nachricht gesendet wird. Der Standardwert lautet InfiniteTimeout.
- Attribute
Ausnahmen
Die Nachrichtenwarteschlange wird gefiltert, um die TimeToReachQueue Eigenschaft zu ignorieren.
Der angegebene TimeToReachQueue Wert ist ungültig. Es kann eine negative Zahl darstellen.
Beispiele
Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachricht TimeToReachQueue abgerufen und festgelegt.
Hinweise
Wenn das durch die TimeToReachQueue Eigenschaft angegebene Intervall abläuft, bevor die Nachricht das Ziel erreicht, verwirft Message Queuing die Nachricht auf eine von zwei Arten. Wenn die Eigenschaft der Nachricht UseDeadLetterQueue lautet true, wird die Nachricht an die Warteschlange mit inaktiven Buchstaben gesendet. Wenn UseDeadLetterQueue ja false, wird die Nachricht ignoriert.
Sie können die Eigenschaft der Nachricht AcknowledgeType festlegen, um anzufordern, dass Message Queuing eine negative Bestätigungsnachricht an die sendende Anwendung zurückgibt, wenn die Nachricht nicht vor Ablauf des Zeitgebers eingeht.
Wenn die TimeToReachQueue Eigenschaft auf 0 Sekunden festgelegt ist, versucht Message Queuing einmal, die Nachricht an das Ziel zu senden – wenn die Warteschlange auf die Nachricht wartet. Wenn die Warteschlange lokal ist, erreicht die Nachricht sie immer.
Wenn der durch die TimeToReachQueue Eigenschaft angegebene Wert größer ist als der durch die TimeToBeReceived Eigenschaft angegebene Wert, TimeToBeReceived hat Vorrang.
Wenn mehrere Nachrichten in einer einzelnen Transaktion gesendet werden, verwendet Message Queuing die TimeToReachQueue Eigenschaft der ersten Nachricht.
