Freigeben über

MessageQueue.QueueName Eigenschaft

  • Referenz

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Ruft den angezeigten Namen für die Warteschlange ab 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 zur Bezeichnung der Warteschlange, auf die diese MessageQueue verweist. Der Wert darf nicht null sein.

Attribute
BrowsableAttribute MessagingDescriptionAttribute

Ausnahmen

ArgumentException

Der Name der Warteschlange ist 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 QueueName mit dem MachineName kombinieren, um einen Anzeigenamen Path für die Warteschlange zu erstellen. Die Syntax für die Anzeigenamenvariation der Path Eigenschaft hängt vom Typ der Warteschlange ab, wie in der folgenden Tabelle gezeigt.

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 festlegen, QueueName ohne die MachineName -Eigenschaft festzulegen, wird die Path -Eigenschaft zu .\QueueName. Andernfalls wird der Path zu MachineName\QueueName.

Die folgende Tabelle zeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Name des lokalen Computers und des direkten Formats Ja
Remotecomputer Ja
Name des Remotecomputers und des direkten Formats Nein

Gilt für:

Weitere Informationen