MessageQueue.FormatName Eigenschap

Definitie

Hiermee haalt u de unieke wachtrijnaam op die Message Queuing heeft gegenereerd op het moment dat de wachtrij is gemaakt.

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

Waarde van eigenschap

De naam voor de wachtrij, die uniek is in het netwerk.

Kenmerken

Uitzonderingen

De Path is niet ingesteld.

– of –

Er is een fout opgetreden bij het openen van een Message Queuing-methode.

Voorbeelden

In het volgende codevoorbeeld wordt de waarde van de eigenschap van een berichtenwachtrij FormatName weergegeven.

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

Opmerkingen

De FormatName eigenschap bevat de indelingsnaam van de wachtrij. Message Queuing gebruikt de indelingsnaam om te bepalen welke wachtrij moet worden geopend en hoe u deze kunt openen. In tegenstelling tot de meeste kenmerken van een wachtrij, is de indelingsnaam geen eigenschap message Queuing-toepassingswachtrij, dus u kunt deze niet openen via het hulpprogramma Message Queuing-beheer. De indelingsnaam is gewoon een unieke naam voor de wachtrij, die Message Queuing genereert wanneer de wachtrij wordt gemaakt of die de toepassing later genereert.

Als u een pad opgeeft met behulp van de padnaamsyntaxis (zoals myComputer\myQueue) in plaats van de syntaxis van de notatienaam wanneer u naar de wachtrij leest of schrijft, vertaalt de primaire domeincontroller (die gebruikmaakt van Active Directory) de Path in de bijbehorende FormatName voordat u de wachtrij opent. Als uw toepassing offline werkt, moet u de syntaxis van de notatienaam gebruiken; anders is de primaire domeincontroller niet beschikbaar om de padomzetting uit te voeren.

In de volgende tabel ziet u of deze eigenschap beschikbaar is in verschillende werkgroepmodi.

Werkgroepmodus Available
Lokale computer Ja
Naam van lokale computer en directe indeling Ja
Externe computer Ja
Naam van externe computer en directe indeling Ja

Van toepassing op

Zie ook