Condividi tramite

Message.TimeToReachQueue Proprietà

Definizione

Spazio dei nomi:
System.Messaging
Assembly:
System.Messaging.dll

Ottiene o imposta la quantità massima di tempo per il 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à

TimeSpan

Limite di tempo per il messaggio per raggiungere la coda di destinazione, a partire dal momento in cui il messaggio viene inviato. Il valore predefinito è InfiniteTimeout.

Attributi
TypeConverterAttribute MessagingDescriptionAttribute

Eccezioni

InvalidOperationException

La coda di messaggi viene filtrata per ignorare la TimeToReachQueue proprietà .

ArgumentException

Il valore specificato per TimeToReachQueue non è valido. Potrebbe 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à del UseDeadLetterQueue messaggio è true, il messaggio viene inviato alla coda dei messaggi non recapitabili. 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 vengono inviati diversi messaggi in una singola transazione, Accodamento messaggi usa la TimeToReachQueue proprietà del primo messaggio.

Si applica a

Vedi anche