MessageQueue.FormatName Proprietà

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

Ottiene il nome univoco della coda generato 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à

String

Nome della coda, univoco nella rete.

Attributi

MessagingDescriptionAttribute

Eccezioni

MessageQueueException

L'oggetto Path non è impostato.

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 del 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 del 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 che 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 conversione del percorso.

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

Modalità gruppo di lavoro	Disponibile
Computer locale	Sì
Computer locale e nome del formato diretto	Sì
Computer remoto	Sì
Computer remoto e nome del formato diretto	Sì

Vedi anche

• Path
• Label
• MessageQueue