Get the source code

Download the source code as a zip file through the SOURCE CODE page, or clone the source with "git clone".

Build the projects

Open amqp.sln in Visual Studio 2012. This solution contains projects for the library on all supported platforms as well as test projects.

To build .Net Micro Framework projects, you need to download .Net Micro Framework SDK from the official CodePlex web site:

To build .Net Compact Framework projects, you need to download Application Builder for Windows Embedded Compact 2013 from here:

Run the tests

The Test.Amqp.Net project contains MSTest test cases that you can run to test the library. You need a broker preconfigured with a queue (or an broker specific entity that maps to an AMQP node named "q1"). Update the address (hostname, port, etc) to match the broker config before you run the tests.

The Test.Amqp.NetMF42/43 project is a NETMF application that you can run in the emulator or deploy to a real device to run. It executes all methods whose names begin with "TestMethod_". Again a preconfigured broker is required. Similarly,

Test.Amqp.NetCF39 project can be run in a .Net Compact Framework environment. You can try it on a VirtualPC virtual machine created using Platform Builder also with the related SDK. If you have a real device, you need an SDK for it too.


The tests contained in the test projects are the best samples to illustrate the usage of the library. Additionally we have samples that show the usage of the library against Azure Service Bus (topic/subscription and event hub).


  • Address: when an address URL is used, the user name and password parts must be URL encoded. ( Address can also be constructed by providing host, port, optional user info separately. It is expected that the URL format is used when the entire connection info is stored in configuration as a single string; while the other is used when the different parts are available in code.

Last edited Oct 2, 2014 at 12:11 PM by ppatierno, version 7