Compartir vía

Message.TimeToReachQueue Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Messaging
Ensamblado:
System.Messaging.dll

Obtiene o establece el límite máximo de tiempo para que el mensaje alcance la cola.

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

Valor de propiedad

TimeSpan

Límite de tiempo para que el mensaje alcance la cola de destino, desde el momento en que se envía. De manera predeterminada, es InfiniteTimeout.

Atributos
TypeConverterAttribute MessagingDescriptionAttribute

Excepciones

InvalidOperationException

La cola de mensajes se filtra para omitir la propiedad TimeToReachQueue.

ArgumentException

El valor especificado para TimeToReachQueue no es válido. Podría representar un número negativo.

Ejemplos

En el ejemplo de código siguiente se obtiene y se establece el valor de la propiedad de TimeToReachQueue un mensaje.

Comentarios

Si el intervalo especificado por la TimeToReachQueue propiedad expira antes de que el mensaje llegue a su destino, Message Queuing descarta el mensaje de una de dos maneras. Si la propiedad UseDeadLetterQueue del mensaje es true, éste se envía a la cola de mensajes no enviados. Si UseDeadLetterQueue es false, se omite el mensaje.

Puede establecer la propiedad del AcknowledgeType mensaje para solicitar que Message Queuing devuelva un mensaje de confirmación negativo a la aplicación de envío si el mensaje no llega antes de que expire el temporizador.

Si la TimeToReachQueue propiedad se establece en 0 segundos, Message Queuing intenta enviar el mensaje a su destino, si la cola está esperando el mensaje. Si la cola es local, el mensaje siempre lo alcanza.

Si el valor especificado por la TimeToReachQueue propiedad es mayor que el valor especificado por la TimeToBeReceived propiedad, TimeToBeReceived tiene prioridad.

Cuando se envían varios mensajes en una sola transacción, Message Queuing usa la TimeToReachQueue propiedad del primer mensaje.

Se aplica a

Consulte también