MessageQueue.Category 속성

정의

큐 범주를 가져오거나 설정합니다.Gets or sets the queue category.

public:
 property Guid Category { Guid get(); void set(Guid value); };
[System.Messaging.MessagingDescription("MQ_Category")]
public Guid Category { get; set; }
member this.Category : Guid with get, set
Public Property Category As Guid

속성 값

큐 범주(메시지 큐 형식 식별자)를 나타내는 Guid입니다. 여기서 애플리케이션을 사용하여 큐를 분류할 수 있습니다.A Guid that represents the queue category (Message Queuing type identifier), which allows an application to categorize its queues. 기본값은 Guid.empty입니다.The default is Guid.empty.

특성

예외

우선 순위 범주가 잘못된 값으로 설정되었습니다.The queue category was set to an invalid value.

메시지 큐 메서드에 액세스하는 동안 오류가 발생한 경우An error occurred when accessing a Message Queuing method.

예제

다음 코드 예제를 가져오고 메시지 큐의 값을 설정 Category 속성입니다.The following code example gets and sets the value of a message queue's Category property.

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

설명

큐 범주에는 애플리케이션을 큐를 분류할 수 있습니다.The queue category allows an application to categorize its queues. 예를 들어, 하나의 범주와 다른 모든 주문 큐에서 모든 청구 큐를 배치할 수 있습니다.For example, you can place all Billing queues in one category and all Order queues in another.

Category 속성은 메시지 큐 형식 ID 속성 (즉, 읽기/쓰기)에 대 한 액세스를 제공을 통해 액세스할 수 합니다 큐 속성 컴퓨터 관리 콘솔의 대화 상자.The Category property provides access to the Message Queuing Type ID property (which is read/write), accessible through the Queue Properties dialog box in the Computer Management Console. 새 범주를 정의할 수 있습니다.You can define a new category. 사용할 수 있지만 NewGuid 는 모든 고유 범주 값을 만들려면 Guid 값, 이러한 작업이 필요는 없습니다.Although you can use NewGuid to create a category value that is unique across all Guid values, such an action is unnecessary. 범주 값이 제거 되지 않은 다른 모든 다른 범주에만 구별 되도록 Guid 값입니다.The category value needs to be distinct only from other categories, not from all other Guid values. 예를 들어, 할당할 수 있습니다 {00000000-0000-0000-0000-000000000001} 으로 Category 큐 집합이 하나에 대 한 및 {00000000-0000-0000-0000-000000000002} 로 Category 다른 집합에 대 한 합니다.For example, you can assign {00000000-0000-0000-0000-000000000001} as the Category for one set of queues and {00000000-0000-0000-0000-000000000002} as the Category for another set.

설정 하는 데 필요한 것은 Category합니다.It is not necessary to set the Category. 값은 null이 될 수 있습니다.The value can be null.

메시지 큐를 수정이 속성을 설정 합니다.Setting this property modifies the Message Queuing queue. 따라서 다른 MessageQueue 인스턴스는 변경 내용의 영향입니다.Therefore, any other MessageQueue instances are affected by the change.

다음 표에서이 속성은 다양 한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.The following table shows whether this property is available in various Workgroup modes.

작업 그룹 모드Workgroup mode 사용 가능Available
로컬 컴퓨터Local computer Yes
로컬 컴퓨터와 직접 형식 이름Local computer and direct format name Yes
원격 컴퓨터Remote computer 아니요No
원격 컴퓨터와 직접 형식 이름Remote computer and direct format name 아니요No

적용 대상

추가 정보