Message.TimeToReachQueue Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

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, set

Public Property TimeToReachQueue As TimeSpan

Eigenschaftswert

TimeSpan

Die maximale Dauer zwischen dem Absenden der Meldung und dem Erreichen der Zielwarteschlange. Der Standardwert ist InfiniteTimeout.

Attribute: TypeConverterAttribute MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

Die TimeToReachQueue-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

ArgumentException

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: