MessageQueue.QueueName Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: