你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

适用于 .NET 的 Azure 存储客户端库

适用于 .NET 的 Azure 存储客户端库提供了一个便捷接口,可用于对 Azure 存储进行调用。 有关 Azure 存储的详细信息,请参阅 Azure 存储简介

数据访问库

用于数据访问的 Azure 存储客户端库的最新版本为版本 12.x.x。Microsoft 建议对新应用程序使用版本 12.x.x。

如果无法将现有应用程序更新到版本 12.x.x,则 Microsoft 建议使用版本 11.x.x。

版本 12.x.x

适用于 .NET 的版本 12.x.x 客户端库是 Azure SDK for .NET 的一部分。 GitHub 上提供适用于 .NET 的 Azure 存储客户端库的源代码。

使用以下版本 12.x.x 库来处理 Blob、文件和队列:

参考 程序包 Source
Azure.Storage.Blobs.Batch NuGet GitHub
Azure.Storage.Blobs 引用 NuGet GitHub
Azure.Storage.Common NuGet GitHub
Azure.Storage.Files.DataLake 引用 NuGet GitHub
Azure.Storage.Files.Shares 引用 NuGet GitHub
Azure.Storage.Queues 引用 NuGet GitHub

版本 11.x.x

GitHub 上提供适用于 .NET 的 Azure 存储客户端库的源代码。

使用以下版本 11.x.x 库来处理 Blob、文件和队列:

参考 程序包 Source
Microsoft.Azure.Storage.Blob 引用 NuGet GitHub
Microsoft.Azure.Storage.Common NuGet GitHub
Microsoft.Azure.Storage.File 引用 NuGet GitHub
Microsoft.Azure.Storage.Queue 引用 NuGet GitHub

资源管理库

用于资源管理的 Azure 存储客户端库的最新版本为版本 1.x.x。Microsoft 建议对新应用程序使用版本 1.x.x。

如果无法将现有应用程序更新到版本 1.x.x,则 Microsoft 建议使用版本 25.x.x。

版本 1.x.x

使用以下版本 1.x.x 库与 Azure 存储资源提供程序配合使用:

参考 程序包
Azure.ResourceManager.Storage 引用 NuGet GitHub

版本 25.x.x

使用以下版本 25.x.x 库与 Azure 存储资源提供程序配合使用:

参考 程序包 Source
Microsoft.Azure.Management.Storage 引用 NuGet GitHub

已知问题

本部分详细介绍了适用于 .NET 的 Azure 存储客户端库的已知问题。

使用 SDK beta 版本时出现 InvalidHeaderValue 错误消息

在极少数情况下,已升级到最新 beta 版或正式版 SDK 的应用程序可能会收到 InvalidHeaderValue 错误消息。 使用任何存储库时,都可能出现此问题。 错误消息类似于以下示例:

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> 

如果已升级到最新的 beta 版本或正式版 SDK,并且遇到此错误,建议降级到以前正式发布的 SDK 版本,以查看问题是否得到解决。 如果问题仍然存在,或者如果建议不可行, 请开具支持票证 以探索进一步的选项。