Message.TimeToReachQueue Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la cantidad máxima de tiempo para que el mensaje llegue a 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, setPublic Property TimeToReachQueue As TimeSpanValor de propiedad
Límite de tiempo para que el mensaje llegue a la cola de destino, comenzando desde el momento en que se envía el mensaje. El valor predeterminado es InfiniteTimeout.
- Atributos
Excepciones
La cola de mensajes se filtra para omitir la TimeToReachQueue propiedad .
El valor especificado para TimeToReachQueue no es válido. Podría representar un número negativo.
Ejemplos
El ejemplo de código siguiente obtiene y 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 estas dos maneras. Si la propiedad del UseDeadLetterQueue mensaje es true, el mensaje se envía a la cola de mensajes fallidos. 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.
