Message.TimeToReachQueue Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Časový limit pro přístup zprávy do cílové fronty počínaje okamžikem odeslání zprávy. Výchozí formát je InfiniteTimeout.
- Atributy
Výjimky
Fronta zpráv je filtrována tak, aby ignorovala TimeToReachQueue vlastnost.
Zadaná hodnota je TimeToReachQueue 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ší, než zpráva dosáhne cíle, služba Řízení front zpráv zprávu zahodí jedním ze dvou způsobů. Pokud je true
vlastnost zprávy UseDeadLetterQueue , zpráva se odešle do fronty nedoručených zpráv. Pokud UseDeadLetterQueue je false
, zpráva se ignoruje.
Vlastnost zprávy AcknowledgeType můžete nastavit tak, aby služba Řízení front zpráv odeslala zprávu s negativním potvrzením 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 jednou pokusí odeslat zprávu do cíle – pokud fronta čeká na zprávu. Pokud je fronta místní, zpráva se k ní vždy dostane.
Pokud je hodnota zadaná TimeToReachQueue vlastností větší než hodnota určená TimeToBeReceived vlastností, TimeToBeReceived má přednost.
Při odeslání několika zpráv v jedné transakci, služba Řízení front zpráv používá TimeToReachQueue vlastnost první zprávy.