Gewusst wie: Erstellen von Instanzen von MessageQueue-Komponenten

Artikel
09/02/2008

Aktualisiert: November 2007

Sie erstellen MessageQueue-Komponenten, wenn Sie Messagingfunktionen in die Anwendung integrieren möchten. MessageQueue-Komponenten ermöglichen es Ihnen, eine Verbindung zu vorhandenen Warteschlangen herzustellen, Meldungen zu senden und zu empfangen und der Anwendung mit einer geringen Menge Code Kommunikationsdienste hinzuzufügen. Angenommen, Sie erstellen ein Auftragserfassungssystem, das Aufträge in Warteschlangen stellt, sobald diese über den Verkaufsaußendienst oder über direkte Kundeninteraktion auf einer Website erteilt wurden. Sie könnten mit dem Hinzufügen einer Instanz der MessageQueue-Komponente zum Projekt beginnen und sie für die Interaktion mit einer vorhandenen OrderEntry-Warteschlange auf dem Message Queuing-Server konfigurieren.

Instanzen der MessageQueue-Komponente können Windows Forms, Web Forms und Komponentenklassen hinzugefügt werden. MessageQueue-Komponenten haben keine visuelle Benutzeroberfläche. Wenn Sie einem visuellen Designer (z. B. dem Windows Forms-Designer) eine Instanz der MessageQueue-Komponente hinzufügen, wird die Komponente in einem kleinen Bereich unterhalb des Formulars angezeigt. Dieser Bereich wird als Komponentenfach bezeichnet und zur Anzeige aller nicht visuellen Elemente verwendet, die mit dem Formular verknüpft sind.

Hinweis:
Nicht visuelle Klassen, die von Component erben, unterstützen eine mit dem Komponentenfach vergleichbare visuelle Entwurfsoberfläche, auf der die MessageQueue-Komponente und andere Komponenten angeordnet werden. Die Anordnung der Elemente in diesem Designer ist nicht von Bedeutung, da die angezeigte Oberfläche für die Endbenutzer der Anwendung nicht sichtbar ist.

Anweisungen zum Konfigurieren von MessageQueue-Komponenten finden Sie unter Konfigurationseigenschaften von Meldungswarteschlangen.

Es gibt mehrere Möglichkeiten, eine Instanz der MessageQueue-Komponente zu erstellen:

Eine Instanz der MessageQueue-Komponente kann von der Registerkarte Komponenten der Toolbox in ein Formular oder den Komponenten-Designer gezogen werden.
Sie suchen die gewünschte Warteschlange im Server-Explorer und fügen sie dem Designer hinzu. Dadurch entsteht eine vorkonfigurierte Instanz der MessageQueue-Komponente, die bereits einen Zeiger auf diese Warteschlange enthält.
Eine Instanz der MessageQueue-Komponente kann programmgesteuert erstellt werden.

So erstellen Sie eine Instanz einer MessageQueue-Komponente mithilfe der Toolbox

Rufen Sie in der Toolbox die Registerkarte Komponenten auf.
Markieren Sie das MessageQueue-Symbol, und ziehen Sie es auf die Designeroberfläche des Formulars oder der Komponente.
Konfigurieren Sie die Komponente. Weitere Informationen hierzu finden Sie unter Konfigurationseigenschaften von Meldungswarteschlangen.

So erstellen Sie eine Instanz der MessageQueue-Komponente im Server-Explorer

Öffnen Sie den Server-Explorer. Weitere Informationen hierzu finden Sie unter Gewusst wie: Zugreifen auf und Initialisieren von Server-Explorer/Datenbank-Explorer.

Erweitern Sie den Knoten Server, und stellen Sie fest, ob der Server mit der gewünschten Warteschlange auf diesem Knoten aufgeführt ist.

Tipp:
Falls der gewünschte Server nicht aufgeführt ist, müssen Sie ihn hinzufügen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Zugreifen auf und Initialisieren von Server-Explorer/Datenbank-Explorer.

Erweitern Sie zunächst den Knoten des gewünschten Servers und dann den darunter befindlichen Knoten Meldungswarteschlangen.

Hinweis:
Wenn sich der Knoten Meldungswarteschlangen nicht erweitern lässt, ist die Message Queuing-Funktion auf dem Computer, auf dem Sie Warteschlangen anzeigen möchten, nicht installiert. Informationen über die Installation und Konfiguration von Message Queuing finden Sie in der Dokumentation zu Message Queuing für Windows 2000 oder Windows NT.

Suchen Sie die Warteschlange, die Sie zum Projekt hinzufügen möchten, und klicken Sie mit der rechten Maustaste auf die gewünschte Warteschlange.
Klicken Sie auf Zum Designer hinzufügen.
Konfigurieren Sie die Komponente. Weitere Informationen hierzu finden Sie unter Konfigurationseigenschaften von Meldungswarteschlangen.

So erstellen Sie eine Instanz der MessageQueue-Komponente programmgesteuert

Erstellen Sie im Code eine Instanz der MessageQueue-Klasse, und legen Sie die Path-Eigenschaft fest, um anzugeben, auf welche vorhandene Warteschlange die Komponente verweisen soll. Der Code kann wie folgt aussehen:

Dim myMQ As New System.Messaging.MessageQueue()
myMQ.Path = ".\MyNewQueue"

     System.Messaging.MessageQueue myMQ =
           new System.Messaging.MessageQueue();
        myMQ.Path = @".\MyNewQueue";

Tipp:
Sie können die Schritte eins und zwei auch mithilfe des folgenden Formats in einem Schritt ausführen:

Dim myMQ2 As New System.Messaging.MessageQueue(".\MyNewQueue")

     System.Messaging.MessageQueue myMQ2 =
           new System.Messaging.MessageQueue(@".\MyNewQueue");

Hinweis:
Über den Warteschlangenpfad, den automatisch generierten Formatnamen der Warteschlange oder über deren nicht eindeutige, beschreibende Bezeichnung können Sie auf die Warteschlange verweisen. Jede dieser Möglichkeiten hat sowohl Vor- als auch Nachteile. Weitere Informationen hierzu finden Sie unter Empfehlungen für Warteschlangenverweise.

Konfigurieren Sie weitere erforderliche Eigenschaften für die Warteschlange. Weitere Informationen hierzu finden Sie unter Konfigurationseigenschaften von Meldungswarteschlangen.

Siehe auch

Konzepte

Konfigurationseigenschaften von Meldungswarteschlangen

Referenz

Gewusst wie: Zugreifen auf und Initialisieren von Server-Explorer/Datenbank-Explorer

Freigeben über