Utiliser la bibliothèque .NET Framework WindowsAzure.ServiceBus héritée avec AMQP 1.0

Le 30 septembre 2026, nous retirerons les bibliothèques WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus et com.microsoft.azure.servicebus du SDK Azure Service Bus, qui ne sont pas conformes aux directives du SDK Azure. Nous mettrons également fin à la prise en charge du protocole SBMP et vous ne pourrez donc plus utiliser ce protocole après le 30 septembre 2026. Migrez avant cette date vers les dernières bibliothèques du SDK Azure, qui offrent des mises à jour de sécurité critiques et des fonctionnalités améliorées.

Bien que les anciennes bibliothèques puissent toujours être utilisées au-delà du 30 septembre 2026, elles ne recevront plus de support officiel ni de mises à jour de Microsoft. Pour plus d’informations, consultez l’annonce concernant l’arrêt de la prise en charge.

Par défaut, le package WindowsAzure.ServiceBus communique avec le service Service Bus à l’aide d’un protocole SOAP dédié nommé SBMP (Service Bus Messaging Protocol). Dans la version 2.1, la prise en charge d’AMQP 1.0 a été ajoutée. Nous vous recommandons de l’utiliser plutôt que le protocole par défaut.

Pour utiliser AMQP 1.0 au lieu du protocole par défaut, vous avez besoin d’une configuration explicite sur la chaîne de connexion Service Bus, ou dans les constructeurs clients par le biais de l’option TransportType. À l'exception de cette modification, le code de l'application reste inchangé lors de l'utilisation d'AMQP 1.0.

Quelques fonctionnalités d’API ne sont pas prises en charge lors de l’utilisation d’AMQP. Ces fonctionnalités non prises en charge sont répertoriées dans la section Différences de comportement. Certains paramètres de configuration avancés ont également une signification différente lors de l’utilisation d’AMQP.

Configurer une chaîne de connexion pour utiliser AMQP 1.0

Ajoutez votre chaîne de connexion avec ;TransportType=Amqp pour indiquer au client d’établir sa connexion à Service Bus à l’aide d’AMQP 1.0. Par exemple,

Endpoint=sb://[namespace].servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=[SAS key];TransportType=Amqp

Où les éléments namespace et SAS key sont obtenus à partir du portail Azure lorsque vous créez un espace de noms Service Bus. Pour plus d’informations, consultez Créer un espace de noms Service Bus à l’aide du portail Azure.

AMQP sur WebSockets

Pour utiliser AMQP sur WebSockets, définissez TransportType dans la chaîne de connexion sur AmqpWebSockets. Par exemple : Endpoint=sb://[namespace].servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=[SAS key];TransportType=AmqpWebSockets.

Sérialisation de messages

Lorsque vous utilisez le protocole par défaut, le comportement de sérialisation par défaut de la bibliothèque cliente .NET consiste à utiliser le type DataContractSerializer pour sérialiser une instance BrokeredMessage en vue de son transport entre la bibliothèque cliente et le service Service Bus. Lorsque vous utilisez le mode de transport AMQP, la bibliothèque cliente utilise le système de type AMQP pour la sérialisation du message réparti dans un message AMQP. Cette sérialisation permet au message d’être reçu et interprété par une application réceptrice potentiellement exécutée sur une plateforme différente, par exemple, une application Java qui utilise l’API JMS pour accéder à Service Bus.

Lorsque vous construisez une instance BrokeredMessage, vous pouvez fournir un objet .NET en tant que paramètre au constructeur pour servir de corps au message. Pour les objets qui peuvent être mappés sur des types primitifs AMQP, le corps est sérialisé en types de données AMQP. Si l’objet ne peut pas être directement mappé sur un type primitif AMQP, c’est-à-dire un type personnalisé défini par l’application, l’objet est sérialisé à l’aide de DataContractSerializer et les octets sérialisés sont envoyés dans un message de données AMQP.

Pour faciliter l’interopérabilité avec les clients autres que .NET, utilisez uniquement des types .NET qui peuvent être sérialisés directement en types AMQP pour le corps du message. Le tableau suivant détaille ces types et le mappage correspondant sur le système de types AMQP.

Différences de comportement

Il existe quelques petites différences dans le comportement de l’API WindowsAzure.ServiceBus lors de l’utilisation d’AMQP par rapport au protocole par défaut :

• La propriété OperationTimeout est ignorée.
• MessageReceiver.Receive(TimeSpan.Zero) est implémenté en tant que MessageReceiver.Receive(TimeSpan.FromSeconds(10)).
• Seuls les destinataires du message qui ont initialement reçu les messages peuvent terminer des messages par des lock-tokens.

Contrôler les paramètres de protocole AMQP

Les API .NET exposent plusieurs paramètres pour contrôler le comportement du protocole AMQP :

• MessageReceiver.PrefetchCount : Contrôle le crédit initial appliqué à un lien. La valeur par défaut est 0.
• MessagingFactorySettings.AmqpTransportSettings.MaxFrameSize : Contrôle la taille de trame AMQP maximale fournie durant la négociation lors de l’ouverture de la connexion. La valeur par défaut est 65 536 octets.
• MessagingFactorySettings.AmqpTransportSettings.BatchFlushInterval : Si les transferts sont exécutables par lots, cette valeur détermine le délai maximal pour l’envoi des dispositions. Héritée par les expéditeurs/destinataires par défaut. Un expéditeur/destinataire individuel peut remplacer la valeur par défaut, qui est de 20 millisecondes.
• MessagingFactorySettings.AmqpTransportSettings.UseSslStreamSecurity : Contrôle si les connexions AMQP sont établies via une connexion TLS. La valeur par défaut est true.

Étapes suivantes

Prêt à en savoir plus ? Visitez les liens suivants :

• Vue d’ensemble du protocole AMQP de Service Bus
• Guide du protocole AMQP 1.0