Condividi tramite


MessageQueue.Label Proprietà

Definizione

Ottiene o imposta la descrizione della coda.

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

Valore della proprietà

Etichetta della coda di messaggi. Il valore predefinito è una stringa vuota ("").

Attributi

Eccezioni

L'etichetta è stata impostata su un valore non valido.

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Esempio

L'esempio di codice seguente ottiene e imposta il valore della proprietà di una coda di Label messaggi.

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

Commenti

La lunghezza massima di un'etichetta della coda di messaggi è di 124 caratteri.

La Label proprietà non deve essere univoca in tutte le code. Tuttavia, se più code condividono lo stesso Label, non è possibile usare il Send(Object) metodo per trasmettere un messaggio a tutti. Se si usa la sintassi dell'etichetta per la Path proprietà quando si invia il messaggio, verrà generata un'eccezione se non Label è univoco.

Nella tabella seguente viene illustrato se questa proprietà è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro Disponibile
Computer locale
Nome del computer locale e del formato diretto
Computer remoto No
Nome del formato diretto e del computer remoto No

Si applica a

Vedi anche