Message.TimeToBeReceived Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Získá nebo nastaví maximální dobu pro přijetí zprávy 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á doba přijetí odeslané zprávy z cílové fronty. Výchozí hodnota je InfiniteTimeout.

Atributy

TypeConverterAttribute MessagingDescriptionAttribute

Výjimky

InvalidOperationException

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

ArgumentException

Zadaná TimeToBeReceived hodnota 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 přijetí odeslané zprávy z cílové fronty. Časový limit zahrnuje dobu strávenou dostat se do cílové fronty a čas strávený čekáním ve frontě před přijetí zprávy.

Upozornění

Při použití závislých klientských počítačů se ujistěte, že jsou hodiny v klientském počítači synchronizovány s hodinami na serveru se spuštěnou službou Řízení front zpráv. V opačném případě může nepředvídatelné chování vést k odeslá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 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 není načtena před vypršením časovače.

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

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

Viz také

• TimeToReachQueue
• InfiniteTimeout