Bibliothèques clientes stockage Azure pour .NET

Les bibliothèques de client du Stockage Azure pour .NET offrent une interface pratique pour effectuer des appels au Stockage Azure. Pour plus d’informations sur Stockage Azure, consultez Présentation du Stockage Azure.

Bibliothèques pour l’accès aux données

La dernière version de la bibliothèque cliente stockage Azure pour l’accès aux données est la version 12.x.x. Microsoft recommande d’utiliser la version 12.x.x pour les nouvelles applications.

Si vous ne pouvez pas mettre à jour les applications existantes vers la version 12.x.x, Microsoft recommande d’utiliser la version 11.x.x.

Version 12.x.x

Les bibliothèques clientes de la version 12.x.x pour .NET font partie du Kit de développement logiciel (SDK) Azure pour .NET. Le code source des bibliothèques clientes stockage Azure pour .NET est disponible sur GitHub.

Utilisez les bibliothèques de version 12.x.x suivantes pour utiliser des objets blob, des fichiers et des files d’attente :

Bibliothèque	Référence	Package	Source
Azure.Storage.Blobs.Batch		NuGet	GitHub
Azure.Storage.Blobs	Référence	NuGet	GitHub
Azure.Storage.Common		NuGet	GitHub
Azure.Storage.Files.DataLake	Référence	NuGet	GitHub
Azure.Storage.Files.Shares	Référence	NuGet	GitHub
Azure.Storage.Queues	Référence	NuGet	GitHub

Version 11.x.x

Le code source des bibliothèques clientes stockage Azure pour .NET est disponible sur GitHub.

Utilisez les bibliothèques de version 11.x.x suivantes pour utiliser des objets blob, des fichiers et des files d’attente :

Bibliothèque	Référence	Package	Source
Microsoft.Azure.Storage.Blob	Référence	NuGet	GitHub
Microsoft.Azure.Storage.Common		NuGet	GitHub
Microsoft.Azure.Storage.File	Référence	NuGet	GitHub
Microsoft.Azure.Storage.Queue	Référence	NuGet	GitHub

Bibliothèques pour la gestion des ressources

La dernière version de la bibliothèque cliente stockage Azure pour la gestion des ressources est la version 1.x.x. Microsoft recommande d’utiliser la version 1.x.x pour les nouvelles applications.

Si vous ne pouvez pas mettre à jour les applications existantes vers la version 1.x.x, Microsoft recommande d’utiliser la version 25.x.x.

Version 1.x.x

Utilisez la bibliothèque de version 1.x.x suivante pour travailler avec le fournisseur de ressources Stockage Azure :

Bibliothèque	Référence	Package	Source
Azure.ResourceManager.Storage	Référence	NuGet	GitHub

Version 25.x.x

Utilisez la bibliothèque 25.x.x suivante pour travailler avec le fournisseur de ressources Stockage Azure :

Bibliothèque	Référence	Package	Source
Microsoft.Azure.Management.Storage	Référence	NuGet	GitHub

Problèmes connus

Cette section détaille les problèmes connus pour les bibliothèques clientes stockage Azure pour .NET.

Message d’erreur InvalidHeaderValue lors de l’utilisation de la version bêta du SDK

Dans de rares scénarios, les applications qui ont effectué une mise à niveau vers la dernière version bêta ou la version généralement disponible du KIT de développement logiciel (SDK) peuvent recevoir un InvalidHeaderValue message d’erreur. Ce problème peut se produire lors de l’utilisation de l’une des bibliothèques de stockage. Le message d’erreur ressemble à l’exemple suivant :

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error> 

Si vous avez effectué une mise à niveau vers la dernière version bêta ou la version en disponibilité générale du KIT de développement logiciel (SDK) et que vous rencontrez cette erreur, il est recommandé de passer à la version précédente en disponibilité générale du Kit de développement logiciel (SDK) pour voir si le problème est résolu. Si le problème persiste ou si la recommandation n’est pas possible, ouvrez un ticket de support pour explorer d’autres options.