Message.TimeToReachQueue Vlastnost

Reference

Definice

Obor názvů:: System.Messaging

Sestavení:: System.Messaging.dll

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

TimeSpan

Č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: TypeConverterAttribute MessagingDescriptionAttribute

Výjimky

InvalidOperationException

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

ArgumentException

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 truevlastnost 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.

Platí pro

Share via