Message.TimeToBeReceived Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Získá nebo nastaví maximální dobu pro zprávu, která má být přijata z cílové fronty.

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

Hodnota vlastnosti

TimeSpan

Celkový čas přijetí odeslané zprávy z cílové fronty. Výchozí formát je InfiniteTimeout.

Atributy

TypeConverterAttribute MessagingDescriptionAttribute

Výjimky

InvalidOperationException

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

ArgumentException

Zadaná hodnota pro TimeToBeReceived je neplatná.

Příklady

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

Poznámky

Vlastnost TimeToBeReceived určuje celkovou dobu, po kterou má být z cílové fronty přijata odeslaná zpráva. Časový limit zahrnuje čas strávený tím, že se dostanete do cílové fronty, a čas strávený čekáním ve frontě před přijetím zprávy.

Upozornění

Pokud používáte závislé klientské počítače, ujistěte se, že hodiny v klientském počítači jsou synchronizovány s hodinami na serveru, na kterém běží služba Řízení front zpráv. V opačném případě by mohlo dojít k nepředvídatelným chováním při odesílání zprávy, jejíž TimeToBeReceived vlastnost není InfiniteTimeout.

Pokud interval určený TimeToBeReceived vlastností vyprší před odebráním zprávy z fronty, 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 negativní potvrzovací zprávu zpět do odesílající aplikace, pokud zpráva nebyla načtena před vypršením platnosti časovače.

Pokud je hodnota zadaná TimeToBeReceived vlastností menší než hodnota zadaná TimeToReachQueue vlastností, TimeToBeReceived má přednost.

Je-li v rámci jedné transakce odesláno několik zpráv, služba Řízení front zpráv používá TimeToBeReceived vlastnost první zprávy.

Viz také

• TimeToReachQueue
• InfiniteTimeout