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.
Ruft die Zeitbegrenzung der Nachricht für das Erreichen der Warteschlange ab oder legt diese fest.
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
Die maximale Dauer zwischen dem Absenden der Meldung und dem Erreichen der Zielwarteschlange. Der Standardwert ist InfiniteTimeout.
- Attribute
Ausnahmen
Die TimeToReachQueue-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
Der für TimeToReachQueue angegebene Wert ist ungültig. Eventuell wurde ein negativer Wert angegeben.
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 ihr Ziel erreicht, 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 dies der Wert 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 eingeht, bevor der Timer abläuft.
Wenn die TimeToReachQueue -Eigenschaft auf 0 Sekunden festgelegt ist, versucht Message Queuing einmal, die Nachricht an ihr Ziel zu senden , wenn die Warteschlange auf die Nachricht wartet. Wenn die Warteschlange lokal ist, erreicht sie die Nachricht immer.
Wenn der von der TimeToReachQueue -Eigenschaft angegebene Wert größer als der von der TimeToBeReceived -Eigenschaft angegebene Wert ist, TimeToBeReceived hat Vorrang.
Wenn mehrere Nachrichten in einer einzelnen Transaktion gesendet werden, verwendet Message Queuing die TimeToReachQueue Eigenschaft der ersten Nachricht.
