MessageQueue.Category 속성

정의

네임스페이스:

System.Messaging

어셈블리:

System.Messaging.dll

큐 범주를 가져오거나 설정합니다.

public:
 property Guid Category { Guid get(); void set(Guid value); };

[System.Messaging.MessagingDescription("MQ_Category")]
public Guid Category { get; set; }

[<System.Messaging.MessagingDescription("MQ_Category")>]
member this.Category : Guid with get, set

Public Property Category As Guid

속성 값

Guid

Guid 애플리케이션이 큐를 분류할 수 있도록 하는 큐 범주(메시지 큐 형식 식별자)를 나타내는 A입니다. 기본값은 Guid.empty입니다.

특성

MessagingDescriptionAttribute

예외

ArgumentException

큐 범주가 잘못된 값으로 설정되었습니다.

MessageQueueException

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

예제

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

// Set the queue's Category property value.
queue.Category =
    new System.Guid("00000000-0000-0000-0000-000000000001");

// Display the new value of the queue's Category property.
Console.WriteLine("MessageQueue.Category: {0}", queue.Category);

설명

큐 범주를 사용하면 애플리케이션이 큐를 분류할 수 있습니다. 예를 들어 모든 청구 큐를 한 범주에 배치하고 모든 주문 큐를 다른 범주에 배치할 수 있습니다.

이 속성은 Category 컴퓨터 관리 콘솔의 큐 속성 대화 상자를 통해 액세스할 수 있는 메시지 큐 형식 ID 속성(읽기/쓰기)에 대한 액세스를 제공합니다. 새 범주를 정의할 수 있습니다. 모든 Guid 값에서 고유한 범주 값을 만드는 데 사용할 NewGuid 수 있지만 이러한 작업은 필요하지 않습니다. 범주 값은 다른 Guid 모든 값이 아닌 다른 범주와만 구별되어야 합니다. 예를 들어 큐의 한 집합에 대해 다른 집합 {00000000-0000-0000-0000-000000000002} 으로 할당 {00000000-0000-0000-0000-000000000001}Category 할 Category 수 있습니다.

를 설정할 Category필요는 없습니다. 값은 .일 null수 있습니다.

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

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

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

추가 정보

• Id
• Label
• GetPublicQueues()