Freigeben über


Message.TimeToReachQueue Eigenschaft

Definition

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, set
Public Property TimeToReachQueue As TimeSpan

Eigenschaftswert

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.

Gilt für:

Weitere Informationen