MessageQueue.Label Propiedad

Definición

Obtiene o establece la descripción de la cola.

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

Valor de propiedad

Etiqueta de la cola de mensajes. El valor predeterminado es una cadena vacía ("").

Atributos

Excepciones

La etiqueta se estableció en un valor incorrecto.

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el ejemplo de código siguiente se obtiene y se establece el valor de la propiedad de una cola de Label mensajes.

// 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);

Comentarios

La longitud máxima de una etiqueta de cola de mensajes es de 124 caracteres.

La Label propiedad no necesita ser única en todas las colas. Sin embargo, si varias colas comparten el mismo Label, no puede usar el Send(Object) método para difundir un mensaje a todos ellos. Si usa la sintaxis de etiqueta para la Path propiedad al enviar el mensaje, se producirá una excepción si no Label es única.

En la tabla siguiente se muestra si esta propiedad está disponible en varios modos de grupo de trabajo.

Modo de grupo de trabajo Disponible
Equipo local
Equipo local y nombre de formato directo
Equipo remoto No
Equipo remoto y nombre de formato directo No

Se aplica a

Consulte también