MessageQueue.Category 속성

정의

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

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입니다. 여기서 애플리케이션을 사용하여 큐를 분류할 수 있습니다. 기본값은 Guid.empty입니다.

특성

예외

우선 순위 범주가 잘못된 값으로 설정되었습니다.

메시지 큐 메서드에 액세스하는 동안 오류가 발생한 경우

예제

다음 코드 예제에서는 메시지 큐 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 모든 값이 아니라 다른 범주와만 구분되어야 합니다. 예를 들어 한 큐 집합에 Category 대해 다른 집합 {00000000-0000-0000-0000-000000000002} 으로 할당 {00000000-0000-0000-0000-000000000001} 할 Category 수 있습니다.

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

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

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

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

적용 대상

추가 정보