Udostępnij za pośrednictwem

Message.TimeToBeReceived Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Pobiera lub ustawia maksymalny czas odbierania komunikatu z kolejki docelowej.

public:
 property TimeSpan TimeToBeReceived { TimeSpan get(); void set(TimeSpan value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
public TimeSpan TimeToBeReceived { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
member this.TimeToBeReceived : TimeSpan with get, set
Public Property TimeToBeReceived As TimeSpan

Wartość właściwości

TimeSpan

Łączny czas odebrania wysłanej wiadomości z kolejki docelowej. Wartość domyślna to InfiniteTimeout.

Atrybuty
TypeConverterAttribute MessagingDescriptionAttribute

Wyjątki

InvalidOperationException

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

ArgumentException

Określona wartość jest TimeToBeReceived nieprawidłowa.

Przykłady

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

Uwagi

Właściwość TimeToBeReceived określa całkowity czas odebrania wysłanej wiadomości z kolejki docelowej. Limit czasu obejmuje czas spędzony na dotarciu do kolejki docelowej i czas spędzony w kolejce przed odebraniem komunikatu.

Przestroga

W przypadku korzystania z zależnych komputerów klienckich upewnij się, że zegar na komputerze klienckim jest synchronizowany z zegarem na serwerze z uruchomioną kolejką komunikatów. W przeciwnym razie nieprzewidywalne zachowanie może spowodować wysłanie komunikatu, którego TimeToBeReceived właściwość nie InfiniteTimeoutjest .

Jeśli interwał określony przez TimeToBeReceived właściwość wygaśnie przed usunięciem komunikatu z kolejki, 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 to false, komunikat jest ignorowany.

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

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

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

Dotyczy

Zobacz też