Comparteix a través de

MessageQueue.MaximumQueueSize Propiedad

  • Referencia

Definición

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

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

Int64

Tamaño máximo de la cola, expresado en kilobytes. El valor predeterminado de Message Queuing especifica que no hay límite.

Atributos
TypeConverterAttribute MessagingDescriptionAttribute

Excepciones

ArgumentException

El tamaño máximo de la cola contiene un valor negativo.

MessageQueueException

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

Se aplica a

Consulte también