MessageQueue.QueueName Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Ruft den Anzeigenamen ab, der die Warteschlange identifiziert, oder legt diesen fest.

public:
 property System::String ^ QueueName { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_QueueName")]
public string QueueName { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_QueueName")>]
member this.QueueName : string with get, set

Public Property QueueName As String

Eigenschaftswert

String

Der Name, der die Warteschlange identifiziert, auf die von diesem MessageQueueverwiesen wird. Der Wert darf nicht sein null.

Attribute

BrowsableAttribute MessagingDescriptionAttribute

Ausnahmen

ArgumentException

Der Warteschlangenname lautet null.

Beispiele

Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachrichtenwarteschlange QueueName abgerufen und festgelegt.

// Set the queue's QueueName property value.
queue.QueueName = "Example Queue";

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

Hinweise

Sie können den QueueNameMachineName Namen kombinieren, um einen Anzeigenamen Path für die Warteschlange zu erstellen. Die Syntax für die Variation des Anzeigenamens der Path Eigenschaft hängt vom Typ der Warteschlange ab, wie in der folgenden Tabelle dargestellt.

Warteschlangentyp	Syntax
Öffentliche Warteschlange	MachineName\QueueName
Private Warteschlange	MachineName\Private$\QueueName
Journalwarteschlange	MachineName\QueueName\Journal$

Verwenden Sie ".", um den lokalen Computer darzustellen.

Das Ändern der QueueName Eigenschaft wirkt sich auf die Path Eigenschaft aus. Wenn Sie die QueueName Eigenschaft ohne Einstellung MachineName festlegen, wird die Path Eigenschaft .\QueueName. Andernfalls wird dies Path\MachineNameQueueName.

In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Name des lokalen Computers und des direkten Formats	Ja
Remotecomputer	Ja
Name des Remotecomputers und des direkten Formats	No

Weitere Informationen

• Path
• MachineName