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.
Azure SDK for .NET