MessageQueue.FormatName Egenskap

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

Egenskapsvärde

Namnet på kön, som är unik i nätverket.

Attribut

MessagingDescriptionAttribute

Undantag

Exempel

I följande kodexempel visas värdet för en meddelandekös FormatName egenskap.

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

Kommentarer

Egenskapen FormatName innehåller formatnamnet för kön. Message Queuing använder formatnamnet för att identifiera vilken kö som ska öppnas och hur du kommer åt den. Till skillnad från de flesta av en kös egenskaper är formatnamnet inte en Message Queuing-programköegenskap, så du kan inte komma åt den via hanteringsverktyget för Message Queuing. Formatnamnet är helt enkelt ett unikt namn för kön, som Message Queuing genererar när kön skapas eller som programmet genererar senare.

Om du anger en sökväg med hjälp av sökvägsnamnssyntaxen (till exempel myComputer\myQueue) i stället för att använda formatnamnssyntaxen när du läser eller skriver till kön översätter den primära domänkontrollanten (som använder služba Active Directory) Path till den associerade FormatName innan du öppnar kön. Om programmet fungerar offline måste du använda formatnamnssyntaxen. Annars är den primära domänkontrollanten inte tillgänglig för att utföra sökvägsöversättningen.

I följande tabell visas om den här egenskapen är tillgänglig i olika arbetsgruppslägen.

Se även

• Path
• Label
• MessageQueue