Sdílet prostřednictvím

Message.TimeToReachQueue Vlastnost

Definice

Obor názvů:
System.Messaging
Sestavení:
System.Messaging.dll

Získá nebo nastaví maximální dobu, po kterou se zpráva dostane do fronty.

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

Hodnota vlastnosti

TimeSpan

Časový limit pro dosažení cílové fronty zprávy počínaje časem odeslání zprávy. Výchozí hodnota je InfiniteTimeout.

Atributy
TypeConverterAttribute MessagingDescriptionAttribute

Výjimky

InvalidOperationException

Fronta zpráv je filtrována tak, aby ignorovala TimeToReachQueue vlastnost.

ArgumentException

Zadaná TimeToReachQueue hodnota je neplatná. Může představovat záporné číslo.

Příklady

Následující příklad kódu získá a nastaví hodnotu vlastnosti zprávy TimeToReachQueue .

Poznámky

Pokud interval určený TimeToReachQueue vlastností vyprší před dosažením cíle zprávy, služba Řízení front zpráv zprávu zahodí jedním ze dvou způsobů. Pokud je truevlastnost zprávy UseDeadLetterQueue , zpráva se odešle do fronty nedoručených zpráv. Pokud UseDeadLetterQueue ano false, zpráva se ignoruje.

Vlastnost zprávy AcknowledgeType můžete nastavit tak, aby služba Řízení front zpráv odeslala zprávu o záporném potvrzení zpět do odesílající aplikace, pokud zpráva nedorazí před vypršením platnosti časovače.

TimeToReachQueue Pokud je vlastnost nastavena na 0 sekund, služba Řízení front zpráv se pokusí zprávu odeslat do cíle – pokud fronta čeká na zprávu. Pokud je fronta místní, zpráva ji vždy dosáhne.

Pokud je hodnota zadaná vlastností větší než hodnota zadaná TimeToReachQueueTimeToBeReceived vlastností, TimeToBeReceived má přednost.

Pokud je v jedné transakci odesláno několik zpráv, služba Řízení front zpráv používá TimeToReachQueue vlastnost první zprávy.

Platí pro

Viz také