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()