MessageQueue.MaximumQueueSize 속성

정의

네임스페이스:

System.Messaging

어셈블리:

System.Messaging.dll

큐의 최대 크기를 가져오거나 설정합니다.

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

속성 값

Int64

큐의 최대 크기(킬로바이트)입니다. 메시지 큐 기본값은 제한이 없음을 지정합니다.

특성

TypeConverterAttribute MessagingDescriptionAttribute

예외

ArgumentException

최대 큐 크기에는 음수 값이 포함됩니다.

MessageQueueException

메시지 큐 메서드에 액세스할 때 오류가 발생했습니다.

예제

다음 코드 예제에서는 메시지 큐 MaximumQueueSize 의 속성 값을 가져오고 설정합니다.

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

설명

관리자 MaximumQueueSize 가 정의하는 컴퓨터의 메시지 할당량과는 별개인 메시지 큐 메시지 스토리지 제한에 대한 액세스를 제공합니다. 메시지 할당량에 대한 자세한 내용은 다음을 참조하세요 MaximumJournalSize.

이 속성을 설정하면 메시지 큐 큐가 수정됩니다. 따라서 다른 MessageQueue 모든 인스턴스는 변경의 영향을 받습니다.

최대 큐 크기 또는 컴퓨터 메시지 할당량을 초과하려고 하면 메시지가 손실될 수 있습니다. 큐 할당량에 도달하면 메시지 큐는 부정적인 승인 메시지를 반환하여 큐가 가득 찼음을 나타내기 위해 보내는 애플리케이션의 관리 큐에 알립니다. 메시지 큐는 큐에 있는 메시지의 총 크기가 한도 아래로 떨어질 때까지 음의 승인을 계속 보냅니다.

다음 표에서는 이 속성을 다양한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.

작업 그룹 모드	사용 가능
로컬 컴퓨터	예
로컬 컴퓨터 및 직접 형식 이름	예
원격 컴퓨터	No
원격 컴퓨터 및 직접 형식 이름	No

추가 정보

• MaximumJournalSize
• InfiniteQueueSize