MessageQueue.FormatName Proprietà

public:
 property System::String ^ FormatName { System::String ^ get(); };

[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }

[<System.Messaging.MessagingDescription("MQ_FormatName")>]
member this.FormatName : string

Public ReadOnly Property FormatName As String

Valore della proprietà

Nome della coda, univoco nella rete.

Attributi

MessagingDescriptionAttribute

Eccezioni

Esempio

Nell'esempio di codice seguente viene visualizzato il valore della proprietà di una coda di FormatName messaggi.

// Display the value of the queue's FormatName property.
Console.WriteLine("MessageQueue.FormatName: {0}", queue.FormatName);

Commenti

La FormatName proprietà contiene il nome di formato della coda. Accodamento messaggi usa il nome del formato per identificare la coda da aprire e come accedervi. A differenza della maggior parte delle caratteristiche di una coda, il nome di formato non è una proprietà della coda dell'applicazione Accodamento messaggi, quindi non è possibile accedervi tramite lo strumento di gestione accodamento messaggi. Il nome del formato è semplicemente un nome univoco per la coda, che l'accodamento messaggi genera quando crea la coda o la quale l'applicazione genera in un secondo momento.

Se si specifica un percorso usando la sintassi del nome del percorso ( ad esempio myComputer\myQueue) anziché usare la sintassi del nome di formato quando si legge o si scrive nella coda, il controller di dominio primario (che usa Active Directory) converte l'oggetto Path nell'oggetto associato FormatName prima di accedere alla coda. Se l'applicazione funziona offline, è necessario usare la sintassi del nome di formato; in caso contrario, il controller di dominio primario non sarà disponibile per eseguire la traduzione del percorso.

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

Si applica a

Vedi anche

• Path
• Label
• MessageQueue