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.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

[<System.Messaging.MessagingDescription("MQ_MaximumQueueSize")>]
member this.MaximumQueueSize : int64 with get, set

Public Property MaximumQueueSize As Long

속성 값

Int64

큐의 최대 크기입니다(단위: KB). 메시지 큐에서는 기본적으로 제한이 없도록 지정합니다.

특성

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 인스턴스는 변경의 영향을 받습니다.

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

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

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

추가 정보

• MaximumJournalSize
• InfiniteQueueSize