Freigeben über

Message Queuing-Warteschlangen

  • Artikel

In diesem Abschnitt wird beschrieben, wie Microsoft Message Queuing-Warteschlangen (auch als MSMQ-Warteschlangen bezeichnet) angegeben werden, wenn Sie den MSMQ-Adapter verwenden. Die Konventionen zum Angeben von Pfaden werden ebenso beschrieben wie die Rolle, die Formatnamen bei der Übersetzung von Pfaden in Warteschlangenziele spielen.

Benennungskonventionen für Warteschlangenpfade

Wenn sich der Warteschlangenname auf einen Pfad bezieht, verwenden Sie die in der folgenden Tabelle aufgeführten Benennungskonventionen.

Warteschlangentyp Syntax für den Pfad
Öffentliche Warteschlange Computername\Warteschlangenname
Private Warteschlange Computername\Private$\QueueName
Journalwarteschlange Computername\QueueName\Journal$
Warteschlange für Computerjournale Hinweis: Verwenden Sie nur für Empfangswarteschlange. Computername\Journal$
Warteschlange für unzustellbare Computer Hinweis: Verwenden Sie nur für Empfangswarteschlange. Computername\Deadletter$
Warteschlange für computertransaktionelle Unzustellbare Nachrichten Hinweis: Nur für Empfangswarteschlange verwenden. Computername\XactDeadletter$

Hinweis

Der Pfad der Warteschlange muss eindeutig sein.

Wenn sich der Warteschlangenname auf einen Formatnamen bezieht, nimmt er die Form einer Zeichenfolge an, die angibt, ob eine Warteschlange öffentlich oder privat ist, gefolgt von einer generierten GUID für die Warteschlange und weiteren Bezeichnern, wenn erforderlich. Verwenden Sie die in der folgenden Tabelle aufgeführten Benennungskonventionen.

Formattyp Syntax für den Formatnamen
Öffentlich FormatName:P ublic=QueueGUID
Direkt FormatName:D IRECT=SPX:NetworkNumber:HostNumber\QueueName

FormatName: DIRECT=TCP:IPAddress\QueueName

FormatName: DIRECT=OS:ComputerName\QueueName

Wenn der Warteschlangenpfad des Sendeports eine Verteilerliste ist, lautet die Syntax für den Warteschlangenpfad wie folgt:

DL=DistributionListGUID

Wenn der Pfad der Sende- oder Empfangswarteschlange eine HTTP- oder HTTPS-URL ist, lautet die Syntax folgendermaßen:

FormatName:DIRECT=http://<Clientname>/msmq/<Warteschlangenname>

FormatName:DIRECT=https://<Clientname>/msmq/<Warteschlangenname>

Hinweis

msmq ist der virtuelle Ordner, der vom Message Queuing in IIS (Internet Information Services, Internetinformationsdienste) erstellt wird.

Hinweis

Sie können nur HTTP zum Senden von Nachrichten verwenden. Sie können keine Nachrichten in einer Warteschlange auf einem Remotecomputer lesen, wenn die Warteschlange mithilfe eines direkten HTTP-Formatnamens geöffnet wird. Sie können jedoch als SOAP formatierte Nachrichten aus einer Remotewarteschlange mithilfe des privaten oder öffentlichen Warteschlangenpfads ohne HTTP empfangen.

Wenn sich der Warteschlangenname auf eine beschreibende Textbezeichnung bezieht, die der Administrator für die Warteschlange angegeben hat, Lautet die Syntax des Warteschlangenpfads, der sich auf diese Bezeichnung bezieht, wie folgt:

LABEL:MyQueue

Hinweis

Bezeichnungen sind nicht immer eindeutig. Aus diesem Grund erhalten Sie eine Fehlermeldung, wenn ein Namenskonflikt vorhanden ist und Sie versuchen, eine Verbindung mit einer bestimmten Warteschlange mithilfe ihrer Bezeichnung herzustellen.

Hinweis

Die Bezeichnung ist ein Transportpflichtfeld für den Adapter.

Die Rolle des Formatnamens

Message Queuing verwendet den Formatnamen, um eine Warteschlange zu identifizieren und zu ermitteln, wie der Zugriff darauf erfolgt. Message Queuing weist der Warteschlange den Formatnamen zu.

Wenn Sie eine Warteschlange mithilfe der Pfadnamensyntax angeben, z. B. EigenerComputer\EigeneWarteschlange, schlägt Message Queuing den Pfad nach, um den zugehörigen Formatnamen zu ermitteln. Message Queuing verwendet dann den Formatnamen, um auf die Warteschlange zuzugreifen. Wenn Sie den Formatnamen angeben, verwendet Message Queuing den von Ihnen verwendeten Formatnamen.

Weitere Informationen zu Formatnamen finden Sie unter „Eigenschaft 'MessageQueue.FormatName'“ in der Hilfe zur .NET Framework-Klassenbibliothek.

Problembehandlung von Warteschlangenpfaden

  • Es tritt eine Ausnahme auf, wenn die Syntax des bereitgestellten Warteschlangenpfads nicht mit einem der Formate übereinstimmt, die an früherer Stelle unter „Benennungskonventionen für Warteschlangenpfade“ beschrieben wurden.

  • Die folgenden Zeichen sind für Computernamen im Warteschlangenpfad nicht zulässig:

    \ ; , + "

    Wenn der Computername aus einer Zahlenfolge besteht, wird eine Ausnahme ausgelöst. Beispiel: 234\private$\queue.

  • Für eine Computerwarteschlange für unzustellbare Nachrichten, eine Computerjournalwarteschlange und eine Computertransaktionswarteschlange für unzustellbare Nachrichten tritt eine Ausnahme auf, wenn der Benutzer eine der Systemwarteschlangen als Zielwarteschlange für den Sendevorgang angibt.

  • System.Messaging.MessageQueue.Exists funktioniert nicht für Remotewarteschlangen. Weitere Informationen finden Sie in der Hilfe zur .NET Framework-Klassenbibliothek unter „Methode 'MessageQueue.Exists'“.

Weitere Informationen

Konfigurieren des MSMQ-Adapters