Bibliotecas cliente de Azure Storage para .NET
Las bibliotecas cliente de Azure Storage para .NET ofrecen una interfaz práctica para realizar llamadas a Azure Storage. Para más información sobre Azure Storage, consulte Introducción a Azure Storage.
Bibliotecas para el acceso a datos
La versión más reciente de la biblioteca cliente de Azure Storage para el acceso a datos es la versión 12.x.x. Microsoft recomienda usar la versión 12.x.x para las nuevas aplicaciones.
Si no puede actualizar las aplicaciones existentes a la versión 12.x.x, Microsoft recomienda usar la versión 11.x.x.
Versión 12.x.x
Las bibliotecas cliente de la versión 12.x.x para .NET forman parte del SDK de Azure para .NET. El código fuente de las bibliotecas cliente de Azure Storage para .NET está disponible en GitHub.
Use las bibliotecas 12.x.x.x siguientes para trabajar con blobs, archivos y colas:
| Biblioteca | Referencia | Paquete | Source |
|---|---|---|---|
| Azure.Storage.Blobs.Batch | NuGet | GitHub | |
| Azure.Storage.Blobs | Referencia | NuGet | GitHub |
| Azure.Storage.Common | NuGet | GitHub | |
| Azure.Storage.Files.DataLake | Referencia | NuGet | GitHub |
| Azure.Storage.Files.Shares | Referencia | NuGet | GitHub |
| Azure.Storage.Queues | Referencia | NuGet | GitHub |
Versión 11.x.x.x
El código fuente de las bibliotecas cliente de Azure Storage para .NET está disponible en GitHub.
Use las siguientes bibliotecas de la versión 11.x.x para trabajar con blobs, archivos y colas:
| Biblioteca | Referencia | Paquete | Source |
|---|---|---|---|
| Microsoft.Azure.Storage.Blob | Referencia | NuGet | GitHub |
| Microsoft.Azure.Storage.Common | NuGet | GitHub | |
| Microsoft.Azure.Storage.File | Referencia | NuGet | GitHub |
| Microsoft.Azure.Storage.Queue | Referencia | NuGet | GitHub |
Bibliotecas para la administración de recursos
La versión más reciente de la biblioteca cliente de Azure Storage para la administración de recursos es la versión 1.x.x. Microsoft recomienda usar la versión 1.x.x para las nuevas aplicaciones.
Si no puede actualizar las aplicaciones existentes a la versión 1.x.x, Microsoft recomienda usar la versión 25.x.x.
Versión 1.x.x
Use la biblioteca 1.x.x.x siguiente para trabajar con el proveedor de recursos de Azure Storage:
| Biblioteca | Referencia | Paquete | Source |
|---|---|---|---|
| Azure.ResourceManager.Storage | Referencia | NuGet | GitHub |
Versión 25.x.x
Use la biblioteca 25.x.x.x siguiente para trabajar con el proveedor de recursos de Azure Storage:
| Biblioteca | Referencia | Paquete | Source |
|---|---|---|---|
| Microsoft.Azure.Management.Storage | Referencia | NuGet | GitHub |
Problemas conocidos
En esta sección se detallan los problemas conocidos de las bibliotecas cliente de Azure Storage para .NET.
Mensaje de error InvalidHeaderValue al usar la versión beta del SDK
En escenarios poco frecuentes, las aplicaciones que se han actualizado a la versión beta más reciente o disponible con carácter general del SDK pueden recibir un InvalidHeaderValue mensaje de error. Este problema puede producirse al usar cualquiera de las bibliotecas de Storage. El mensaje de error es similar al ejemplo siguiente:
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 ha actualizado a la versión beta más reciente o disponible con carácter general del SDK y experimenta este error, se recomienda cambiar a la versión anterior disponible con carácter general del SDK para ver si el problema se resuelve. Si el problema persiste o si la recomendación no es factible, abra una incidencia de soporte técnico para explorar más opciones.
Azure SDK for .NET