Gewusst wie: Senden einfacher Meldungen

Aktualisiert: November 2007

Mit einer Instanz der MessageQueue-Komponente können Sie mit nur zwei Zeilen Code einfache Meldungen an eine Warteschlange senden. Zum Senden einer einfachen Meldung müssen Sie folgende Aktionen ausführen:

• Stellen Sie eine Verbindung zur Warteschlange her, an die eine Meldung gesendet werden soll.

• Geben Sie ein geeignetes Formatierungsprogramm für die zu sendenden Daten an. Das Formatierungsprogramm steuert, welcher Datentyp in einer Meldung gesendet werden kann und wie die Daten gespeichert werden. Bei einfachen Fällen kann das Standardformatierungsprogramm verwendet werden. Weitere Informationen hierzu finden Sie unter Meldungsserialisierung.

• Rufen Sie die Send-Methode auf, wobei Sie das zu sendende Objekt übergeben.

Herstellen einer Verbindung zur Warteschlange

Nachdem Sie sich für eine Warteschlange entschieden haben, mit der Sie kommunizieren möchten, müssen Sie eine Instanz der MessageQueue-Komponente erstellen, die auf die gewünschte Warteschlange verweist. Sie können diese Komponente entweder über die Toolbox, mit dem Server-Explorer für das Projekt oder mit dem MessageQueue-Konstruktor erstellen.

So erstellen Sie eine Verbindung zu der Warteschlange, mit der kommuniziert werden soll

1. Erstellen Sie eine Instanz der MessageQueue-Komponente. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen von Instanzen von MessageQueue-Komponenten.

2. Stellen Sie mithilfe der Path-Eigenschaft der Komponente eine Verbindung mit der Warteschlange her, mit der Sie mithilfe des Pfades, des Formatnamens oder der Bezeichnung kommunizieren möchten.

   Hinweis:
   Wenn Sie die Komponente im Server-Explorer erstellt haben, wird die Path-Eigenschaft automatisch auf den Pfad dieser Warteschlange festgelegt.

Bereitstellen der zu sendenden Daten

Jede MessageQueue-Komponente enthält eine Reihe von Standardeigenschaften, die auf alle Meldungen angewendet werden, die von dieser Komponente gesendet werden, es sei denn, Sie geben in einer einzelnen Meldung etwas anderes an. Im einfachsten Fall können Sie mit den Standardeigenschaften der Komponente eine einfache Meldung an die Warteschlange senden. Weitere Informationen über diese Eigenschaften finden Sie unter den Ausführungen zu Standardeigenschaften von Meldungen.

Mit der Send-Methode wird eine Meldung angegeben und an die Warteschlange gesendet. Sie können Objekte, einfache Datentypen, Streams und andere Arten von Daten in einer einfachen Meldung senden.

Die MessageQueue-Komponente übernimmt die im Send-Argument der Methode angegebenen Daten, speichert sie in einer Meldung und sendet die Meldung an die angegebene Warteschlange.

Hinweis:
Sie können mit dem Message-Objekt auch viel komplexere Meldungen an eine Warteschlange senden. Es ist außerdem möglich, Meldungen als Teil einer Transaktion zu senden. Weitere Informationen hierzu finden Sie unter Gewusst wie: Senden komplexer Meldungen.

So senden Sie eine einfache Meldung

• Übernehmen Sie im Eigenschaftenfenster für die MessageQueue-Komponente den Standardwert für Formatter, oder legen Sie die Eigenschaft auf XmlMessageFormatter fest, wenn Sie den Standardwert geändert haben.

  Senden Sie mit der Send-Methode eine einfache Meldung an die Warteschlange, und geben Sie die Meldung dabei als Argument der Methode an.

  ' Create a connection to the queue.
  Dim MessageQueue1 As New System.Messaging.MessageQueue(".\YourQueue")
  ' Send an integer.
  MessageQueue1.Send(1)
  ' Send a string.
  MessageQueue1.Send("Hello world")
  

       // Create a connection to the queue.
          System.Messaging.MessageQueue mq =
             new System.Messaging.MessageQueue(@".\YourQueue");
          // Send an integer.
          mq.Send(1);
          // Send a string.
          mq.Send("Hello world");
  

  Dieses Codebeispiel ist auch als IntelliSense-Codeausschnitt verfügbar. Sie finden das Element in der Codeausschnittauswahl unter Windows-Betriebssystem > Meldungswarteschlangen. Weitere Informationen finden Sie unter Gewusst wie: Einfügen von Ausschnitten in den Code (Visual Basic).

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Instanzen von MessageQueue-Komponenten

Gewusst wie: Senden komplexer Meldungen

Gewusst wie: Überprüfen von Meldungen zur Entwurfszeit

Konzepte

Transaktionale Meldungsverarbeitung

Weitere Ressourcen

Senden und Serialisieren von Meldungen