Message.Label Property

Definition

Получает или задает определяемую приложением строку в кодировке Юникод, описывающую данное сообщение.Gets or sets an application-defined Unicode string that describes the message.

public:
 property System::String ^ Label { System::String ^ get(); void set(System::String ^ value); };
[System.Messaging.MessagingDescription("MsgLabel")]
public string Label { get; set; }
member this.Label : string with get, set
Public Property Label As String

Property Value

String

Метка сообщения.The label of the message. Значение по умолчанию — пустая строка ("").The default is an empty string ("").

Attributes

Exceptions

Очередь сообщений фильтруется, чтобы не учитывать свойство Label.The message queue is filtered to ignore the Label property.

Examples

В следующем примере кода получается и задается значение Label свойства сообщения.The following code example gets and sets the value of a message's Label property.

Remarks

Метку сообщения можно использовать для решения ряда задач.You can use a message label 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.

Applies to

See also