Message.Label Property
Gets or sets an application-defined Unicode string that describes the message.
[Visual Basic] 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);
Property Value
The label of the message. The default is an empty string ("").
Exceptions
| Exception Type | Condition |
|---|---|
| InvalidOperationException | The message queue is filtered to ignore the Label property. |
Remarks
You can use a message label can be used for several purposes. For example, you can use it for display purposes or to selectively process messages based on the label value. The label does not need to be unique across messages.
Message queue and message labels represent an application-defined value that can help identify the queue or message in human-readable terms. It is the responsibility of the application to interpret the label contents, which have no intrinsic meaning to the Message Queuing application.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
.NET Framework Security:
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries From Partially Trusted Code
See Also
Message Class | Message Members | System.Messaging Namespace | MessageQueue.Label
