Freigeben über


MessageQueue.MachineName Eigenschaft

Definition

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

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

Attribute

Ausnahmen

MachineName ist null. - oder -

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

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

Gilt für:

Weitere Informationen