Message.TimeToBeReceived Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il limite di tempo massimo per la ricezione del messaggio dalla coda di destinazione.
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 TimeSpanValore della proprietà
Tempo totale per la ricezione di un messaggio inviato dalla coda di destinazione. Il valore predefinito è InfiniteTimeout.
- Attributi
Eccezioni
La coda di messaggi viene filtrata in modo che venga ignorata la proprietà TimeToBeReceived.
Il valore specificato per TimeToBeReceived non è valido.
Esempio
L'esempio di codice seguente ottiene e imposta il valore della proprietà di TimeToBeReceived un messaggio.
Commenti
La TimeToBeReceived proprietà specifica il tempo totale per la ricezione di un messaggio inviato dalla coda di destinazione. Il limite di tempo include il tempo trascorso alla coda di destinazione e il tempo trascorso in attesa nella coda prima che il messaggio venga ricevuto.
Attenzione
Quando si usano computer client dipendenti, assicurarsi che l'orologio nel computer client sia sincronizzato con l'orologio nel server che esegue Accodamento messaggi. In caso contrario, il comportamento imprevedibile potrebbe risultare quando si invia un messaggio la cui TimeToBeReceived proprietà non InfiniteTimeoutè .
Se l'intervallo specificato dalla TimeToBeReceived proprietà scade prima che il messaggio venga rimosso dalla coda, l'accodamento messaggi elimina il messaggio in uno dei due modi. Se la proprietà UseDeadLetterQueue del messaggio è true, il messaggio viene inviato alla coda inattiva. Se UseDeadLetterQueue è false, il messaggio viene ignorato.
È possibile impostare la proprietà del AcknowledgeType messaggio per richiedere che Accodamento messaggi invii un messaggio di riconoscimento negativo all'applicazione di invio se il messaggio non viene recuperato prima della scadenza del timer.
Se il valore specificato dalla proprietà è minore del valore specificato dalla TimeToBeReceivedTimeToReachQueue proprietà, TimeToBeReceived ha la precedenza.
Quando vengono inviati diversi messaggi in una singola transazione, Accodamento messaggi usa la TimeToBeReceived proprietà del primo messaggio.
