Message.TimeToReachQueue Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.