The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Message Queue Sample 

Download sample

This sample shows how to send and receive message-queue messages from Windows Forms applications.

Security noteSecurity Note

This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustrate the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code be used for purposes other than as intended.

To open the sample file in Solution Explorer

  1. Click Download Sample.

    The File Download message box appears.

  2. Click Open, and on the left column of the zip folder window, click Extract all files.

    The Extraction Wizard opens.

  3. Click Next. You can change the directory that the files will be extracted to, and then click Next again.

  4. Make sure that the Show extracted files check box is selected, and click Finish.

  5. Double-click the MSMQListener solution file.

    The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location is not trusted. Click OK to continue.

To run this sample

  1. Press F5 to compile and run the MSMQListener project.

  2. Open another instance of Visual Studio and open the MSMQClient solution file.

  3. Press F5 to compile and run the MSMQClient project.


The application sends messages to a private message queue. The messages are received one by one and processed by the MSMQListener. This sample has two components that work together:

  • A Windows Forms client that sends messages. It is a simple application that lets the user post orders to a private message queue.

  • A Windows Forms listener that processes the messages sent by the client. The listener begins by receiving all orders that are currently in the queue. It then listens for additional orders and processes them as they come in. The listener responds to a ReceiveCompleted event when a message has been received.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft