Condividi tramite


Message.TimeToBeReceived Proprietà

Definizione

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, set
Public Property TimeToBeReceived As TimeSpan

Valore 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.

Si applica a

Vedi anche