Message.TimeToReachQueue Eigenschap

Definitie

Hiermee wordt de maximale tijdsduur voor het bericht opgehaald of ingesteld om de wachtrij te bereiken.

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

Waarde van eigenschap

De tijdslimiet voor het bericht om de doelwachtrij te bereiken, te beginnen vanaf het moment dat het bericht wordt verzonden. De standaardwaarde is InfiniteTimeout.

Kenmerken

Uitzonderingen

De berichtenwachtrij wordt gefilterd om de TimeToReachQueue eigenschap te negeren.

De opgegeven TimeToReachQueue waarde is ongeldig. Dit kan een negatief getal vertegenwoordigen.

Voorbeelden

In het volgende codevoorbeeld wordt de waarde van de eigenschap van een bericht TimeToReachQueue opgehaald en ingesteld.

Opmerkingen

Als het interval dat door de TimeToReachQueue eigenschap is opgegeven, verloopt voordat het bericht de bestemming bereikt, wordt het bericht door Message Queuing op twee manieren verwijderd. Als de eigenschap van UseDeadLetterQueue het bericht is true, wordt het bericht verzonden naar de wachtrij met dode letters. Als UseDeadLetterQueue dat het is false, wordt het bericht genegeerd

U kunt de eigenschap van AcknowledgeType het bericht zo instellen dat Message Queuing een negatief bevestigingsbericht terugstuurt naar de verzendende toepassing als het bericht niet binnenkomt voordat de timer verloopt.

Als de TimeToReachQueue eigenschap is ingesteld op 0 seconden, probeert Message Queuing het bericht eenmaal naar de bestemming te verzenden. Als de wachtrij op het bericht wacht. Als de wachtrij lokaal is, wordt het bericht altijd bereikt.

Als de waarde die is opgegeven door de TimeToReachQueue eigenschap groter is dan de waarde die is opgegeven door de TimeToBeReceived eigenschap, TimeToBeReceived heeft voorrang.

Wanneer meerdere berichten in één transactie worden verzonden, gebruikt Message Queuing de TimeToReachQueue eigenschap van het eerste bericht.

Van toepassing op

Zie ook