Message.TimeToReachQueue Proprietà

Definizione

Ottiene o imposta il limite di tempo massimo impiegato dal messaggio per raggiungere la coda.

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

Valore della proprietà

Il limite di tempo necessario a un messaggio, dal momento in cui viene inviato, per raggiungere la coda di destinazione. Il valore predefinito è InfiniteTimeout.

Attributi

Eccezioni

La coda di messaggi viene filtrata in modo che venga ignorata la proprietà TimeToReachQueue.

Il valore specificato per TimeToReachQueue non è valido. Può rappresentare un numero negativo.

Esempio

L'esempio di codice seguente ottiene e imposta il valore della proprietà di TimeToReachQueue un messaggio.

Commenti

Se l'intervallo specificato dalla TimeToReachQueue proprietà scade prima che il messaggio raggiunga la destinazione, Accodamento messaggi rimuove 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 arriva prima della scadenza del timer.

Se la TimeToReachQueue proprietà è impostata su 0 secondi, Accodamento messaggi tenta una sola volta di inviare il messaggio alla destinazione, se la coda è in attesa del messaggio. Se la coda è locale, il messaggio lo raggiunge sempre.

Se il valore specificato dalla TimeToReachQueue proprietà è maggiore del valore specificato dalla TimeToBeReceived proprietà, TimeToBeReceived ha la precedenza.

Quando più messaggi vengono inviati in una singola transazione, Accodamento messaggi usa la TimeToReachQueue proprietà del primo messaggio.

Si applica a

Vedi anche