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.