MessageQueue.MachineName Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Ruft den Namen des Computers ab, auf dem sich die Message Queuing-Warteschlange befindet, oder legt diesen fest.

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

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

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

Public Property MachineName As String

Eigenschaftswert

String

Der Name des Computers, auf dem sich die Warteschlange befindet. Die Standardeinstellung von Message Queuing ist "." für den lokalen Computer.

Attribute

BrowsableAttribute MessagingDescriptionAttribute

Ausnahmen

ArgumentException

MachineName ist null. - oder -

Der Computername ist ungültig. Möglicherweise wurde eine falsche Syntax verwendet.

MessageQueueException

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

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

// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";

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

Hinweise

Ist MachineName eine integrale Komponente der Anzeigenamensyntax der Warteschlange Path. Die folgende Tabelle zeigt die Syntax, die Sie für eine Warteschlange eines angegebenen Typs verwenden sollten, wenn Sie den Warteschlangenpfad mithilfe des Anzeigenamens identifizieren möchten.

Warteschlangentyp	Syntax
Öffentliche Warteschlange	MachineName\QueueName
Private Warteschlange	MachineName\Private$\QueueName
Journalwarteschlange	MachineName\QueueName\Journal$
Warteschlange des Maschinenjournals	MachineName\Journal$
Warteschlange für unzustellbare Computer	MachineName\Deadletter$
Warteschlange für computertransaktionelle Unzustellbare Nachrichten	MachineName\XactDeadletter$

Verwenden Sie "." für den lokalen Computer, wenn Sie angeben MachineName. Für diese Eigenschaft wird nur der Computername erkannt, z. B Server0. . Die MachineName -Eigenschaft unterstützt das IP-Adressformat nicht.

Wenn Sie den Path als MachineNamedefinieren, löst die Anwendung eine Ausnahme aus, wenn sie offline arbeitet, da der Domänencontroller für die Pfadübersetzung erforderlich ist. Daher müssen Sie für die Path Syntax verwendenFormatName, wenn Sie offline arbeiten.

Die MachineNameEigenschaften , Pathund QueueName sind miteinander verknüpft. Wenn Sie die MachineName Eigenschaft ändern, ändert sich die Path Eigenschaft. Es wird aus dem neuen MachineName und dem QueueNameerstellt. Durch Ändern von Path (z. B. zur Verwendung der Formatnamensyntax) werden die MachineName Eigenschaften und QueueName zurückgesetzt, um auf die neue Warteschlange zu verweisen. Wenn die QueueName Eigenschaft leer ist, wird auf Path die Journal Warteschlange des von Ihnen angegebenen Computers festgelegt.

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

Weitere Informationen

• QueueName
• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()