Bibliotecas de cliente do Armazenamento do Azure para .NET

As bibliotecas de clientes do Armazenamento do Azure para .NET oferecem uma interface fácil de usar para fazer chamadas ao Armazenamento do Azure. Para obter mais informações sobre o Armazenamento do Azure, consulte Introdução ao Armazenamento do Azure.

Bibliotecas para acesso a dados

A versão mais recente da biblioteca de clientes do Armazenamento do Azure para acesso a dados é a versão 12.x.x. A Microsoft recomenda usar a versão 12.x.x para novos aplicativos.

Se você não puder atualizar aplicativos existentes para a versão 12.x.x, a Microsoft recomenda usar a versão 11.x.x.

Versão 12.x.x

As bibliotecas de cliente versão 12.x.x para .NET fazem parte do SDK do Azure para .NET. O código-fonte das bibliotecas de cliente do Armazenamento do Azure para .NET está disponível no GitHub.

Use as seguintes bibliotecas da versão 12.x.x para trabalhar com blobs, arquivos e filas:

Biblioteca	Referência	Pacote	Fonte
Azure.Storage.Blobs.Batch		NuGet	GitHub
Azure.Storage.Blobs	Referência	NuGet	GitHub
Azure.Storage.Common		NuGet	GitHub
Azure.Storage.Files.DataLake	Referência	NuGet	GitHub
Azure.Storage.Files.Shares	Referência	NuGet	GitHub
Azure.Storage.Queues	Referência	NuGet	GitHub

Versão 11.x.x

O código-fonte das bibliotecas de cliente do Armazenamento do Azure para .NET está disponível no GitHub.

Use as seguintes bibliotecas da versão 11.x.x para trabalhar com blobs, arquivos e filas:

Biblioteca	Referência	Pacote	Fonte
Microsoft.Azure.Storage.Blob	Referência	NuGet	GitHub
Microsoft.Azure.Storage.Common		NuGet	GitHub
Microsoft.Azure.Storage.File	Referência	NuGet	GitHub
Microsoft.Azure.Storage.Queue	Referência	NuGet	GitHub

Bibliotecas para gerenciamento de recursos

A versão mais recente da biblioteca de clientes do Armazenamento do Azure para gerenciamento de recursos é a versão 1.x.x. A Microsoft recomenda usar a versão 1.x.x para novos aplicativos.

Se você não puder atualizar aplicativos existentes para a versão 1.x.x, a Microsoft recomenda usar a versão 25.x.x.

Versão 1.x.x

Use a seguinte biblioteca versão 1.x.x para trabalhar com o provedor de recursos do Armazenamento do Azure:

Biblioteca	Referência	Pacote	Fonte
Azure.ResourceManager.Storage	Referência	NuGet	GitHub

Versão 25.x.x

Use a seguinte biblioteca versão 25.x.x para trabalhar com o provedor de recursos do Armazenamento do Azure:

Biblioteca	Referência	Pacote	Fonte
Microsoft.Azure.Management.Storage	Referência	NuGet	GitHub

Problemas conhecidos

Esta seção detalha os problemas conhecidos das bibliotecas de clientes do Armazenamento do Azure para .NET.

Mensagem de erro InvalidHeaderValue ao usar a versão beta do SDK

Em cenários raros, os aplicativos que atualizaram para a versão beta mais recente ou geralmente disponível do SDK podem receber uma InvalidHeaderValue mensagem de erro. Esse problema pode ocorrer ao usar qualquer uma das bibliotecas de Armazenamento. A mensagem de erro é semelhante ao seguinte exemplo:

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> 

Se você tiver atualizado para a versão beta mais recente ou geralmente disponível do SDK e tiver esse erro, é recomendável fazer downgrade para a versão anterior geralmente disponível do SDK para ver se o problema é resolvido. Se o problema persistir ou se a recomendação não for viável, abra um tíquete de suporte para explorar outras opções.