Service Bus -- .Net AttachmentPlugin to send and receive messages about 1MB
Published May 30 2021 08:19 PM 4,110 Views


Before we start please read this .Net send and receive Service Bus message , Service Bus message size limit and .Net AttachmentPlugin Simple code.

Following the first document you may understand how to set up a .Net project to send and receive service Bus messages. However, it has limitation for the size of message, Standard pricing tier 256 KB and premium pricing tier 1MB. Then how about the message above 1MB? You may receive an error message about “QuotaExceededException” when your message above the limit. So how to resolve this issue when you need to send message above 1MB?

We plan to release a preview function that allow users send and receive messages up to 100 MB. But currently we don’t have an estimated time. This blog is to explain how to use an AttachmentPlugin in .Net program to send and receive message above 1MB. This is a work around only implement in .Net program. If your system is using other languages like Python, Java and so on, we suggest you separating the messages and change the size of the messages.

Now, let’s talk about how to use this AttachmentPlugin.


The work principle of this AttahchmentPlugin is implement Claim Check pattern with Azure Storage. It based on this pattern to store message data in Azure Storage Account Container (data Store) and pass a Claim Check to Azure Service Bus. Azure Service Bus can use the Claim Check to retrieve the stored information.



  • This Plugin is to save the message to Storage Account, so you need to have an Azure Storage Account first.
  • Then you can get the AttachmentPlugin from Microsoft Visual Studio “Manage Nugget Packages” and search for “ServiceBus.AttachmentPlugin”. Or if you are using Nuget Package Manager Console, you can use this script in below to install it.

           PM> Install-Package ServiceBus.AttachmentPlugin



Parameters :

  • Service Bus Connection String: You can get it from Azure Portal, your Service Bus Namespace “Shared access Policies


  • Your Service Bus Queue name or Service Bus Topic name and Subscription name
  • Storage Account Connection String: you can get from Azure portal. Check your storage account “Access key”.



  • And Storage Account Container name.


After getting all the values, then you can try to use this sample program to send and receive messages.


using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using ServiceBus.AttachmentPlugin;

using System.Threading.Tasks;

using Microsoft.Azure.ServiceBus;

using Microsoft.Azure.ServiceBus.Core;


namespace ServiceBusAttachmentPlugin


    class Program


        const string ServiceBusConnectionString = "<your Service Bus Connection String >";

        const string ServiceBusQueueName = "<your Service Bus Queue name >";

        const string StorageConnectionString = "<your Storage Account Connection String >";

        const string StorageContainerName = "<your Storage Account Container Name>";

        const string ServiceBusTopicName = "<your Service Bus topic name>";

        const string ServiceBusSubscriptionName = "<your Service Bus subscription name>";


    private static async Task MainAsync()


            var sender = new MessageSender(ServiceBusConnectionString, ServiceBusQueueName);

            var config = new AzureStorageAttachmentConfiguration(StorageConnectionString, StorageContainerName);


            byte[] msgBytes = Encoding.ASCII.GetBytes("Test message");

            await sender.SendAsync(new Message(msgBytes));

/*If you want to receive message from Service Bus Topic/Subscription, you need to use this EntityNameHelper to get subscriptionPath, then use MessageReceiver() function to receive message .*/

//string subscriptionPath = EntityNameHelper.FormatSubscriptionPath(ServiceBusTopicName, ServiceBusSubscriptionName);

//IMessageReceiver receiver = new MessageReceiver(ServiceBusConnectionString, subscriptionPath, ReceiveMode.ReceiveAndDelete);

            var receiver = new MessageReceiver(ServiceBusConnectionString, ServiceBusQueueName, ReceiveMode.ReceiveAndDelete);


            var taskrc = await receiver.ReceiveAsync();//Here we use ReceiveAndDelete mode first, if you need use Peeklock mode, please complete the message.

            var message = taskrc.Body;

           // await receiver.CompleteAsync(message.SystemProperties.LockToken);


        static void Main(string[] args)








  • You can use your own way to serialize your message, like use function JsonConvert.SerializeObject(). But you need to deserialize the object to your message when you receive it.
  • This sample code use SendAsync() and ReceiveAsync() functions, so we need use “await” to make sure the message complete. For the difference between sync and Async please read my previous blog Service Bus –Complete Message Asynchronously or Synchronously? - Microsoft Tech Community
  • We use RecivedAndDelete mode to receive the message, if you need use PeekLock mode, please remember to complete the message. For example in Microsoft.Azure.ServiceBus use receiver.CompleteAsync(message.SystemProperties.LockToken).Please check Service Bus Receive mode and .Net example  for more examples.


  • After using the sample code, we sent messages successfully. You can find your message in Azure portal->Service Bus explorer. But it only can Peek 32 messages.


  • You also can check your messages from Service Bus Explorer application, you can download it from GitHub Service Bus Explorer. You can use your Service Bus Connection String to connect your Service Bus. You would get more details about this message.


  • In addition, these messages will save to your Storage Account container. You can also check it from your container.


In conclusion, this Service Bus AttachmentPlugin is a work around to send and receive messages above 1MB. You need to keep them before you want to receive these messages. And if you received the message from Service Bus the blobs would still in the Azure Storage Account. If you need to delete them when Azure Service Bus receive the message you can add functions to delete it from Storage Account. It would have additional cost in Storage Account, so it would be the limit for this Service Bus AttachmentPlugin.  You can weigh your own interests to make decisions.

Version history
Last update:
‎May 30 2021 08:16 PM
Updated by: