MessageQueue.MaximumQueueSize Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém ou define o tamanho máximo da fila.

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 da propriedade

Int64

O tamanho máximo, em quilobytes, da fila. O padrão do Enfileiramento de Mensagens especifica que não há limite.

Atributos

TypeConverterAttribute MessagingDescriptionAttribute

Exceções

ArgumentException

O tamanho máximo da fila contém um valor negativo.

MessageQueueException

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.

Exemplos

O exemplo de código a seguir obtém e define o valor da propriedade de uma fila de MaximumQueueSize mensagens.

// 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);

Comentários

O MaximumQueueSize fornece acesso ao limite de armazenamento de mensagens de Enfileiramento de Mensagens, que é separado da cota de mensagens do computador definida pelo administrador. Para obter mais informações sobre a cota de mensagens, consulte MaximumJournalSize.

Definir essa propriedade modifica a fila de Enfileiramento de Mensagens. Portanto, quaisquer outras MessageQueue instâncias são afetadas pela alteração

Se for feita uma tentativa de exceder o tamanho máximo da fila ou a cota de mensagens do computador, as mensagens poderão ser perdidas. Quando a cota de fila é atingida, o Enfileiramento de Mensagens notifica a fila de administração do aplicativo de envio para indicar que a fila está cheia, retornando uma mensagem de confirmação negativa. O Enfileiramento de Mensagens continua a enviar confirmações negativas até que o tamanho total das mensagens na fila caia abaixo do limite.

A tabela a seguir mostra se essa propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho	Disponível
Computador local	Yes
Nome do computador local e do formato direto	Yes
Computador remoto	Não
Computador remoto e nome de formato direto	Não

Confira também

• MaximumJournalSize
• InfiniteQueueSize