MessageQueue.MaximumQueueSize 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 tamaño máximo de la cola.
public:
property long MaximumQueueSize { long get(); void set(long value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.SizeConverter))]
[System.Messaging.MessagingDescription("MQ_MaximumQueueSize")]
public long MaximumQueueSize { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.SizeConverter))>]
[<System.Messaging.MessagingDescription("MQ_MaximumQueueSize")>]
member this.MaximumQueueSize : int64 with get, set
Public Property MaximumQueueSize As Long
Valor de propiedad
Tamaño máximo de la cola, expresado en kilobytes. El valor predeterminado de Message Queuing especifica que no hay límite.
- Atributos
Excepciones
El tamaño máximo de la cola contiene un valor negativo.
Error al obtener acceso a un método de Message Queuing.
Ejemplos
En el ejemplo de código siguiente se obtiene y se establece el valor de la propiedad de una cola de MaximumQueueSize mensajes.
// Set the queue's MaximumQueueSize property value.
queue.MaximumQueueSize = 10;
// Display the new value of the queue's MaximumQueueSize property.
Console.WriteLine("MessageQueue.MaximumQueueSize: {0}",
queue.MaximumQueueSize);
Comentarios
MaximumQueueSize proporciona acceso al límite de almacenamiento de mensajes de Message Queuing, que es independiente de la cuota de mensajes del equipo que define el administrador. Para obtener más información sobre la cuota de mensajes, vea MaximumJournalSize.
Al establecer esta propiedad, se modifica la cola message Queuing. Por lo tanto, cualquier otra MessageQueue instancia se ve afectada por el cambio.
Si se intenta superar el tamaño máximo de la cola o la cuota de mensajes del equipo, es posible que se pierdan los mensajes. Cuando se alcanza la cuota de cola, Message Queuing notifica a la cola de administración de la aplicación de envío para indicar que la cola está llena, devolviendo un mensaje de confirmación negativo. Message Queuing sigue enviando confirmaciones negativas hasta que el tamaño total de los mensajes de la cola cae por debajo del límite.
En la tabla siguiente se muestra si esta propiedad está disponible en varios modos de grupo de trabajo.
Modo de grupo de trabajo | Disponible |
---|---|
Equipo local | Sí |
Equipo local y nombre de formato directo | Sí |
Equipo remoto | No |
Equipo remoto y nombre de formato directo | No |