MessageQueue.Label プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MessageQueue.Label プロパティ

キューの説明を取得または設定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property Label As
 String

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As String

value = instance.Label

instance.Label = value

public string Label { get;
 set; }

C++

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

/** @property */
public String get_Label ()

/** @property */
public void set_Label (String value)

JScript

public function get Label
 () : String

public function set Label
 (value : String)

プロパティ値
メッセージキューのラベル。既定値は空の文字列 ("") です。

例外

例外の種類	条件
ArgumentException	ラベルに無効な値が設定されています。
MessageQueueException	メッセージキューのメソッドにアクセスしたときにエラーが発生しました。

解説

メッセージキューラベルの最大長は半角で 124 文字です。

Label プロパティは、すべてのキューで一意である必要はありません。しかし、複数のキューで同じ Label を共有している場合に、Send(Object) メソッドを使用して、これらのすべてのキューにメッセージをブロードキャストすることはできません。メッセージを送信するときに Path プロパティのラベル構文を使用する場合、Label が一意でないと例外がスローされます。

このプロパティが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	○
ローカルコンピュータと直接書式名	○
リモートコンピュータ	×
リモートコンピュータと直接書式名	×

使用例

メッセージキューの 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);

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