MessageQueue.MaximumQueueSize Propriedade

Definição

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 de Propriedade

O tamanho máximo, em kilobytes, da fila. O padrão da Fila de Mensagens especifica que não existe limite.

Atributos

Exceções

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

Ocorreu um erro ao aceder a um método de Fila de Mensagens.

Exemplos

O seguinte exemplo de código obtém e define o valor da propriedade de MaximumQueueSize uma fila de 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);

Observações

Fornece MaximumQueueSize acesso ao limite de armazenamento de mensagens na Fila de Mensagens, que é separado da quota de mensagens do computador definida pelo administrador. Para mais informações sobre a quota de mensagens, veja MaximumJournalSize.

Definir esta propriedade modifica a fila de Fila 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 quota de mensagens do computador, as mensagens podem ser perdidas. Quando a quota de fila é atingida, a Fila de Mensagens notifica a fila de administração da aplicação de envio para indicar que a fila está cheia, devolvendo uma mensagem de confirmação negativa. A Fila de Mensagens continua a enviar confirmações negativas até que o tamanho total das mensagens na fila desça abaixo do limite.

A tabela seguinte mostra se esta propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho Available
Computador local Yes
Computador local e nome do formato direto Yes
Computador remoto No
Computador remoto e nome do formato direto No

Aplica-se a

Ver também