共用方式為


MessageQueue.Label 屬性

定義

取得或設定佇列描述。

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

屬性值

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

屬性

例外狀況

標籤設為無效值。

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

範例

下列程式代碼範例會取得並設定消息佇列的 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 不是唯一的,則會擲回例外狀況。

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

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

適用於

另請參閱