次の方法で共有


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 が一意でない場合は例外がスローされます。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード 在庫有り
ローカル コンピューター はい
ローカル コンピューターと直接の形式名 はい
リモート コンピューター いいえ
リモート コンピューターと直接の形式名 いいえ

適用対象

こちらもご覧ください