Service Bus Relayed Messaging Tutorial
The following topics describe how to build a simple Windows Azure Service Bus client application and service using the Service Bus “relay” messaging capabilities. For a corresponding tutorial that describes how to build an application that uses the Service Bus “brokered,” or asynchronous messaging capabilities, see the Service Bus Brokered Messaging .NET Tutorial.
The topics that are contained in this section are intended to give you quick exposure to the Service Bus programming experience. They are designed to be completed in the order listed at the bottom of this topic. Working through this tutorial gives you an introductory understanding of the steps that are required to create an Service Bus client and service application. Like their WCF counterparts, a service is a construct that exposes one or more endpoints, each of which exposes one or more service operations. The endpoint of a service specifies an address where the service can be found, a binding that contains the information that a client must communicate with the service, and a contract that defines the functionality provided by the service to its clients. The main difference between a WCF and an Service Bus service is that the endpoint is exposed in the cloud instead of locally on your computer.
After you work through the sequence of topics in this tutorial, you will have a running service, and a client that can invoke the operations of the service. The first topic describes how to set up an account. The next three topics describe how to define a service that uses a contract, how to implement the service, and how to configure the service in code. They also describe how to host and run the service. The service that is created is self-hosted and the client and service run on the same computer. You can configure the service by using either code or a configuration file. For more information, see Configuring a WCF Service to Register with the Service Bus and Building a Service for the Service Bus.
The next three topics describe how to create a client application, configure the client application, and create and use a client that can access the functionality of the host. For more information, see Building a Service Bus Client Application and Discovering and Exposing a Service Bus Service.
All of the topics in this section assume that you are using Visual Studio 2012 as the development environment. If you are using another development environment, ignore the Visual Studio-specific instructions.
For more in-depth information about how to create Service Bus client applications and hosts, see the Developing Applications that Use Service Bus section.
In This Section
Other ResourcesService Bus Brokered Messaging .NET Tutorial