MessageQueue.MachineName Eigenschaft
Definition
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 ihn 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, setPublic Property MachineName As StringEigenschaftswert
Der Name des Computers, auf dem sich die Warteschlange befindet. Der Message Queuing-Standardwert ist ".", der lokale Computer.
- Attribute
Ausnahmen
MachineName ist null.
- oder -
Der Name des Computers ist ungültig, möglicherweise weil die Syntax falsch ist.
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
Dies MachineName ist eine integrale Komponente der Syntax des Anzeigenamens 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$ |
| Computerjournalwarteschlange | MachineName\Journal$ |
| Computerwarteschlange mit inaktiven Buchstaben | MachineName\Deadletter$ |
| Machine transactional dead-letter queue | MachineName\XactDeadletter$ |
Verwenden Sie "." für den lokalen Computer, wenn Sie den MachineName. Nur der Computername wird für diese Eigenschaft erkannt, Server0z. B. . Die MachineName Eigenschaft unterstützt das IP-Adressformat nicht.
Wenn Sie die Path Definition im Sinne der MachineNameAnwendung festlegen, löst die Anwendung eine Ausnahme aus, wenn Sie offline arbeiten, da der Domänencontroller für die Pfadübersetzung erforderlich ist. Daher müssen Sie die FormatNamePath Syntax verwenden, wenn Sie offline arbeiten.
Die MachineNameEigenschaften Pathund QueueName Eigenschaften sind verknüpft. Das Ändern der MachineName Eigenschaft bewirkt, dass die Path Eigenschaft geändert wird. Es wird aus dem neuen MachineName und dem QueueName. Wenn Sie die Path Formatnamensyntax ändern möchten, werden die MachineName und QueueName die Eigenschaften zurückgesetzt, um auf die neue Warteschlange zu verweisen. Wenn die QueueName Eigenschaft leer ist, wird sie Path auf die Journalwarteschlange des von Ihnen angegebenen Computers festgelegt.
In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokaler Computer | Ja |
| Name des lokalen Computers und des direkten Formats | Ja |
| Remotecomputer | Ja |
| Name des Remotecomputers und des direkten Formats | No |
