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.