MessageQueue.Label 속성

정의

큐 설명을 가져오거나 설정합니다.Gets or sets the queue description.

public:
 property System::String ^ Label { System::String ^ get(); void set(System::String ^ value); };
[System.Messaging.MessagingDescription("MQ_Label")]
public string Label { get; set; }
member this.Label : string with get, set
Public Property Label As String

속성 값

메시지 큐의 레이블입니다.The label for the message queue. 기본값은 빈 문자열("")입니다.The default is an empty string ("").

특성

예외

레이블이 잘못된 값으로 설정되었습니다.The label was set to an invalid value.

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

예제

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

// Set the queue's Label property value.
queue.Label = "Example Queue";

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

설명

메시지 큐 레이블의 최대 길이 124 자입니다.The maximum length of a message queue label is 124 characters.

Label 속성이 모든 큐에서 고유할 필요는 없습니다.The Label property does not need to be unique across all queues. 그러나 동일한 여러 큐를 공유 하는 경우 Label를 사용할 수 없습니다는 Send(Object) 이들 모두에 메시지를 브로드캐스팅하는 방법입니다.However, if multiple queues share the same Label, you cannot use the Send(Object) method to broadcast a message to all of them. 레이블 구문을 사용 하는 경우는 Path 메시지를 보낼 때 속성에는 예외가 발생 하는 경우는 Label 고유 하지 않습니다.If you use the label syntax for the Path property when you send the message, an exception will be thrown if the Label is not unique.

다음 표에서이 속성은 다양 한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.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

적용 대상

추가 정보