MessageQueue.Label プロパティ
キューの説明を取得または設定します。
Public Property Label As String
[C#]
public string Label {get; set;}
[C++]
public: __property String* get_Label();public: __property void set_Label(String*);
[JScript]
public function get Label() : String;public function set Label(String);
プロパティ値
メッセージ キューのラベル。既定値は空の文字列 ("") です。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentException | ラベルに無効な値が設定されています。 |
| MessageQueueException | メッセージ キューの API にアクセスしたときにエラーが発生しました。 |
解説
メッセージ キュー ラベルの最大長は半角で 124 文字です。
Label プロパティは、すべてのキューで一意である必要はありません。しかし、複数のキューで同じ Label を共有している場合に、 Send メソッドを使用して、これらのすべてのキューにメッセージをブロードキャストすることはできません。メッセージを送信するときに Path プロパティのラベル構文を使用する場合、 Label が一意でないと例外がスローされます。
このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。
| ワークグループ モード | 使用可否 |
|---|---|
| ローカル コンピュータ | はい |
| ローカル コンピュータ + 直接書式名 | はい |
| リモート コンピュータ | いいえ |
| リモート コンピュータ + 直接書式名 | いいえ |
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
MessageQueue クラス | MessageQueue メンバ | System.Messaging 名前空間 | Path | FormatName | GetPublicQueuesByLabel | GetPublicQueues | GetMessageQueueEnumerator