MessageQueue.Label 屬性

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

取得或設定佇列描述。

public:
 property System::String ^ Label { System::String ^ get(); void set(System::String ^ value); };

[System.Messaging.MessagingDescription("MQ_Label")]
public string Label { get; set; }

[<System.Messaging.MessagingDescription("MQ_Label")>]
member this.Label : string with get, set

Public Property Label As String

屬性值

String

訊息佇列的標記。 預設為空字串 ("")。

屬性

MessagingDescriptionAttribute

例外狀況

ArgumentException

標籤設為無效值。

MessageQueueException

存取訊息佇列方法時發生錯誤。

範例

下列程式代碼範例會取得並設定消息佇列的 Label 屬性值。

// 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 個字元。

屬性 Label 不需要在所有佇列中是唯一的。 不過，如果多個佇列共用相同的 Label，則您無法使用 Send(Object) 方法將訊息廣播至所有佇列。 如果您在傳送訊息時使用 屬性的 Path 標籤法，如果 Label 不是唯一的，則會擲回例外狀況。

下表顯示此屬性是否可在各種工作組模式中使用。

工作組模式	可用
本機電腦	是
本機計算機和直接格式名稱	是
遠端電腦	否
遠端電腦和直接格式名稱	否

另請參閱

• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()