Condividi tramite


MessageQueue.FormatName Proprietà

Definizione

Ottiene il nome univoco generato per la coda da Accodamento messaggi al momento della creazione della coda.

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

Eccezioni

La proprietà Path non è impostata.

-oppure-

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

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.

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

Si applica a

Vedi anche