Message.TimeToReachQueue Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Messaging

Zestaw:: System.Messaging.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia maksymalny czas dotarcia do kolejki przez komunikat.

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

Wartość właściwości

TimeSpan

Limit czasu, przez który komunikat dociera do kolejki docelowej, począwszy od momentu wysłania komunikatu. Wartość domyślna to InfiniteTimeout.

Atrybuty: TypeConverterAttribute MessagingDescriptionAttribute

Wyjątki

InvalidOperationException

Kolejka komunikatów jest filtrowana w celu zignorowania TimeToReachQueue właściwości.

ArgumentException

Określona wartość jest TimeToReachQueue nieprawidłowa. Może to reprezentować liczbę ujemną.

Przykłady

Poniższy przykład kodu pobiera i ustawia wartość właściwości komunikatu TimeToReachQueue .

Uwagi

Jeśli interwał określony przez TimeToReachQueue właściwość wygaśnie przed dotarciem komunikatu do miejsca docelowego, kolejkowanie komunikatów odrzuca komunikat na jeden z dwóch sposobów. Jeśli właściwość komunikatu UseDeadLetterQueue to true, wiadomość jest wysyłana do kolejki utraconych wiadomości. Jeśli UseDeadLetterQueue jest falseto , komunikat jest ignorowany

Możesz ustawić właściwość komunikatu AcknowledgeType , aby zażądała, aby kolejkowanie komunikatów wysyłało negatywną wiadomość potwierdzenia z powrotem do aplikacji wysyłającej, jeśli komunikat nie pojawi się przed wygaśnięciem czasomierza.

TimeToReachQueue Jeśli właściwość jest ustawiona na 0 sekund, kolejkowanie komunikatów próbuje wysłać komunikat do miejsca docelowego — jeśli kolejka czeka na komunikat. Jeśli kolejka jest lokalna, komunikat zawsze do niego dociera.

Jeśli wartość określona przez TimeToReachQueue właściwość jest większa niż wartość określona przez TimeToBeReceived właściwość, TimeToBeReceived ma pierwszeństwo.

Gdy w jednej transakcji jest wysyłanych kilka komunikatów, kolejkowanie komunikatów używa TimeToReachQueue właściwości pierwszego komunikatu.

Dotyczy