Message.TimeToReachQueue Egenskap

Definition

Namnområde:
System.Messaging
Sammansättning:
System.Messaging.dll

Hämtar eller anger den maximala tiden för meddelandet att nå kön.

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

Egenskapsvärde

TimeSpan

Tidsgränsen för meddelandet att nå målkön, med början från den tidpunkt då meddelandet skickas. Standardvärdet är InfiniteTimeout.

Attribut
TypeConverterAttribute MessagingDescriptionAttribute

Undantag

InvalidOperationException

Meddelandekön filtreras för att ignorera egenskapen TimeToReachQueue .

ArgumentException

Det angivna värdet är TimeToReachQueue ogiltigt. Det kan representera ett negativt tal.

Exempel

Följande kodexempel hämtar och anger värdet för ett meddelandes TimeToReachQueue egenskap.

Kommentarer

Om intervallet som anges av TimeToReachQueue egenskapen upphör att gälla innan meddelandet når målet, tar Message Queuing bort meddelandet på något av två sätt. Om meddelandets egenskap är UseDeadLetterQueueskickas true meddelandet till kön med obeställbara meddelanden. Om UseDeadLetterQueue är falseignoreras meddelandet

Du kan ange att meddelandets AcknowledgeType egenskap ska begära att Message Queuing skickar tillbaka ett negativt bekräftelsemeddelande till det sändande programmet om meddelandet inte tas emot innan timern upphör att gälla.

Om egenskapen TimeToReachQueue är inställd på 0 sekunder försöker Message Queuing en gång att skicka meddelandet till målet – om kön väntar på meddelandet. Om kön är lokal når meddelandet alltid den.

Om värdet som anges av TimeToReachQueue egenskapen är större än det värde som anges av TimeToBeReceived egenskapen har TimeToBeReceived företräde.

När flera meddelanden skickas i en enda transaktion använder Message Queuing egenskapen för TimeToReachQueue det första meddelandet.

Gäller för

Se även