Message.Label プロパティ

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

Message.Label プロパティ

メッセージを記述するアプリケーション定義の Unicode 文字列を取得または設定します。

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

Visual Basic (宣言)

Public Property Label As
 String

Visual Basic (使用法)

Dim instance As Message
Dim value As String

value = instance.Label

instance.Label = value

C#

public string Label { get;
 set; }

C++

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

J#

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

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

JScript

public function get Label
 () : String

public function set Label
 (value : String)

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

例外

例外の種類	条件
InvalidOperationException	フィルタ処理されたメッセージ キューが、Label プロパティを無視します。

解説

メッセージ ラベルを使用する目的はいくつか考えられます。メッセージ ラベルは、表示目的で使用できます。たとえば、ラベルの値に基づいてメッセージを選択的に処理するために使用できます。ラベルは、他のメッセージのラベルと重複していてもかまいません。

メッセージ キュー ラベルとメッセージ ラベルは、アプリケーション定義の値を表します。これらのラベルは、ユーザーの判読できる単語などを使用して、キューやメッセージを識別するのに便利です。ラベルの内容の解釈は、アプリケーションで行う必要があります。ラベル自体には、メッセージ キュー アプリケーションで解釈される特別な意味はありません。

使用例

メッセージの Label プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// Set the message's Label property.
orderMessage.Label = "Order Message";

// Display the new value of the message's Label property.
Console.WriteLine("Message Label: {0}", orderMessage.Label);

C++

// Set the message's Label property.
orderMessage->Label = "Order Message";

// Display the new value of the message's Label property.
Console::WriteLine("Message Label: {0}", orderMessage->Label);

J#

// Set the message's Label property.
orderMessage.set_Label("Order Message");
// Display the new value of the message's Label property.
Console.WriteLine("Message Label: {0}", orderMessage.get_Label());

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
MessageQueue.Label