MessageQueue.MachineName 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 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

Gilt für:

Freigeben über