Message.TimeToBeReceived 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 el límite máximo de tiempo para recibir el mensaje de la cola de destino.
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, setPublic Property TimeToBeReceived As TimeSpanValor de propiedad
Tiempo total requerido para recibir un mensaje enviado desde la cola de destino. De manera predeterminada, es InfiniteTimeout.
- Atributos
Excepciones
La cola de mensajes se filtra para omitir la propiedad TimeToBeReceived.
El valor especificado para TimeToBeReceived no es válido.
Ejemplos
En el ejemplo de código siguiente se obtiene y se establece el valor de la propiedad de TimeToBeReceived un mensaje.
Comentarios
La TimeToBeReceived propiedad especifica el tiempo total de un mensaje enviado que se va a recibir de la cola de destino. El límite de tiempo incluye el tiempo dedicado a llegar a la cola de destino y el tiempo empleado en esperar en la cola antes de recibir el mensaje.
Precaución
Al usar equipos cliente dependientes, asegúrese de que el reloj del equipo cliente está sincronizado con el reloj en el servidor que ejecuta Message Queuing. De lo contrario, un comportamiento imprevisible podría dar lugar al enviar un mensaje cuya TimeToBeReceived propiedad no InfiniteTimeoutes .
Si el intervalo especificado por la TimeToBeReceived propiedad expira antes de quitar el mensaje de la cola, 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 se recupera antes de que expire el temporizador.
Si el valor especificado por la TimeToBeReceived propiedad es menor que el valor especificado por la TimeToReachQueue propiedad, TimeToBeReceived tiene prioridad.
Cuando se envían varios mensajes en una sola transacción, Message Queuing usa la TimeToBeReceived propiedad del primer mensaje.
