<%@ Page Language="C#" MasterPageFile="~/howto/howto.master" %> <%@ Register TagPrefix=Acme Namespace=Acme %> <%@ Register TagPrefix="Acme" TagName="SourceRef" Src="~/util/SrcRef.ascx"%>

How Do I...Pass a complex type through a message queue?

Message queuing makes it easy for application developers to communicate with application programs quickly and reliably by sending and receiving messages. Messaging provides you with guaranteed message delivery and a robust, fail-safe way to carry out many of your business processes.

The MessageQueue component allows you to easily incorporate message-based communication into your applications. Using this component and its associated language features, you can send and receive messages, explore existing queues, create and delete queues, and perform a variety of other operations using a simple programming model.

The sample illustrates how to use the MessageQueue component to send a complex type through a message queue. To run the sample you have to have Message Queuing installed on your system.

Sending a complex type through a queue is very simple. It is actually as simple as sending a string (see MQSend sample). The MessageQueue component handles everything automatically. All you have to do is:
  1. Create an instance of the MessageQueue component and set its Path property:

    MessageQueue mq = new MessageQueue(".\\MyQueue"); Dim mq As MessageQueue = New MessageQueue(".\MyQueue") MessageQueue* mq = new MessageQueue(mqPath);


  2. Calling Send method to send a complex object:

    MyComplexType myType = new MyComplexType(); mq.Send(myType); Dim myType As MyComplexType = New MyComplexType() mq.Send(myType) Customer* customer = new MyComplexType; mq->Send(MyComplexType);

Example