MessageQueue.MachineName-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Property MachineName As String
'Usage
Dim instance As MessageQueue
Dim value As String

value = instance.MachineName

instance.MachineName = value

public string MachineName { get; set; }

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

/** @property */
public String get_MachineName ()

/** @property */
public void set_MachineName (String value)

public function get MachineName () : String

public function set MachineName (value : String)

Eigenschaftenwert

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

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der MachineName ist NULL (Nothing in Visual Basic).
ArgumentException	Der Computername ist ungültig. Möglicherweise wurde eine falsche Syntax verwendet.
MessageQueueException	Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

Der MachineName ist ein Bestandteil der Syntax für den angezeigten Namen für den Path einer Warteschlange. In der folgenden Tabelle wird die Syntax dargestellt, die für eine Warteschlange eines bestimmten Typs erforderlich ist, wenn der Pfad der Warteschlange über den angezeigten Namen angegeben werden soll.

Warteschlangentyp	Syntax
Öffentliche Warteschlange	MachineName\QueueName
Private Warteschlange	MachineName\Private$\QueueName
Journalwarteschlange	MachineName\QueueName\Journal$
Journalwarteschlange des Computers	MachineName\Journal$
Dead Letter-Warteschlange des Computers	MachineName\Deadletter$
Transaktionale Dead Letter-Warteschlange des Computers	MachineName\XactDeadletter$

Verwenden Sie zur Angabe des MachineName "." für den lokalen Computer. Bei dieser Eigenschaft wird nur der Computername akzeptiert, z. B. Server0. Die MachineName-Eigenschaft unterstützt kein IP-Adressformat.

Wenn der Path über den MachineName definiert wird, löst die Anwendung bei der Offlineausführung eine Ausnahme aus, da für die Übersetzung des Pfades der Domänencontroller erforderlich ist. Der Path muss daher für die Offlinearbeit in der FormatName-Syntax angegeben werden.

Die MachineName-Eigenschaft, die Path-Eigenschaft und die QueueName-Eigenschaft hängen zusammen. Wenn die MachineName-Eigenschaft geändert wird, ändert sich damit auch die Path-Eigenschaft. Sie wird aus den neuen Werten des MachineName und des QueueName erstellt. Wenn der Path geändert wird, um beispielsweise die Syntax für den Formatnamen zu verwenden, werden die MachineName-Eigenschaft und die QueueName-Eigenschaft zurückgesetzt, sodass sie auf die neue Warteschlange verweisen. Wenn in der QueueName-Eigenschaft kein Wert angegeben ist, wird der Path auf die Journalwarteschlange des angegebenen Computers festgelegt.

Der folgenden Tabelle können Sie entnehmen, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Lokaler Computer + direkter Formatname	Ja
Remotecomputer	Ja
Lokaler Computer + direkter Formatname	Nein

Beispiel

Im folgenden Codebeispiel wird der Wert der MachineName-Eigenschaft einer Meldungswarteschlange 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);

// Set the queue's MachineName property value to the name of the local
// computer.
queue.set_MachineName(".");
// Display the new value of the queue's MachineName property.
Console.WriteLine("MessageQueue.MachineName: {0}", 
    queue.get_MachineName());

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

MessageQueue-Klasse
MessageQueue-Member
System.Messaging-Namespace
QueueName
Path
MessageQueue.FormatName-Eigenschaft
GetPublicQueues
GetMessageQueueEnumerator

Freigeben über