Azure Service Bus .NET Standard client is generally available. With it comes support for .NET Core and the .NET framework. And as mentioned in an earlier post it also supports Mono/Xamarin for cross-platform application development. This is only the start of greater things to come.
Here is a full list of the supported platforms. Ours will be .NET Standard version 1.3.
Service Bus .NET Samples
We have queue, topic, and session samples to get you going and we'll be adding more samples over time.
For now try out a sample or two from this list:
- Sample for sending and receiving to/from a Service Bus queue using a QueueClient
- Sample for sending to a Topic and receiving from a Subscription
- Sample for sending and receiving session based messages, great if you need First In First Out (FIFO) order
- Sample for sending and receiving to/from a Service Bus queue using MessageSender and MessageReceiver
- Sample for sending and receiving session based messages to/from Service Bus queues using SessionClient
- Sample for configuring and managing rules for Subscriptions
Plugins
We also have plugins you can use with this new client such as the Message ID plugin shown below. and we have one plugin contribution from the community!
Message ID plugin for Azure Service Bus
The Message ID plugin for Azure Service Bus allows for the message ID on outgoing messages to be set using custom logic. This is very useful for having more control over de-duplication where you want to make sure you remove duplicate messages being sent to your queue or topic by setting a value of the Message ID property that makes the most sense for your particular scenario.
How to use
In order to use this plugin you will need to setup the following:
- An Azure subscription
- A Service Bus namespace
Below is a simple example of how to use the plugin.
var messageIdPlugin = new MessageIdPlugin((msg) => Guid.NewGuid().ToString("N")); var queueClient = new QueueClient("{ServiceBusConnectionString}", "{ServiceBusEntityName}"); queueClient.RegisterPlugin(messageIdPlugin); var message = new Message(Encoding.UTF8.GetBytes("Message with GUID message ID")); await queueClient.SendAsync(message).ConfigureAwait(false); // message.MessageId will be assigned a GUID in a 32 digit format w/o hyphens or braces
Open Source
This .NET Standard client is open source and if you want to contribute you can! You can submit a code fix for a bug, submit a new feature request and provide other feedback in our GitHub repo.
Thank you to our community members who helped us to get here!
You can find the NuGet package here and documentation here.