Message.TimeToBeReceived Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger den maximala tiden för meddelandet som ska tas emot från målkön.
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, setPublic Property TimeToBeReceived As TimeSpanEgenskapsvärde
Den totala tiden för ett skickat meddelande som ska tas emot från målkön. Standardvärdet är InfiniteTimeout.
- Attribut
Undantag
Meddelandekön filtreras för att ignorera egenskapen TimeToBeReceived .
Det angivna värdet är TimeToBeReceived ogiltigt.
Exempel
Följande kodexempel hämtar och anger värdet för ett meddelandes TimeToBeReceived egenskap.
Kommentarer
Egenskapen TimeToBeReceived anger den totala tiden för ett skickat meddelande som ska tas emot från målkön. Tidsgränsen omfattar den tid som ägnas åt att komma till målkön och den tid som ägnas åt att vänta i kön innan meddelandet tas emot.
Caution
När du använder beroende klientdatorer ska du se till att klockan på klientdatorn synkroniseras med klockan på den server som kör Message Queuing. Annars kan oförutsägbart beteende uppstå när du skickar ett meddelande vars TimeToBeReceived egenskap inte InfiniteTimeoutär .
Om intervallet som anges av TimeToBeReceived egenskapen upphör att gälla innan meddelandet tas bort från kön, 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 hämtas innan timern upphör att gälla.
Om värdet som anges av TimeToBeReceived egenskapen är mindre än det värde som anges av TimeToReachQueue egenskapen har TimeToBeReceived företräde.
När flera meddelanden skickas i en enda transaktion använder Message Queuing egenskapen för TimeToBeReceived det första meddelandet.
