| Links | |
|---|---|
| 发行说明 | 发行说明 |
| SDK 下载 | NuGet |
| API 文档 | 参考文档 |
| 示例 | .NET代码示例 |
| 入门 | Azure Cosmos DB .NET SDK 入门 |
| 当前受支持的框架 | Microsoft .NET Framework 4.5 |
Warning
Azure Cosmos DB .NET SDK v2.x 将于 2024 年 8 月 31 日停用。届时，此 SDK 和所有使用此 SDK 的应用程序将继续运行，Azure Cosmos DB 只是将停止为此 SDK 提供进一步的维护和支持。 建议迁移到最新版本的 .NET SDK v3 SDK。
注释
如果使用的是 .NET Framework，请参阅面向 .NET Standard 的 .NET SDK 最新版本 3.x。
发行历史
版本历史记录保留在 Azure Cosmos DB .NET SDK 源存储库中。 有关每个版本中功能发布和修复的 bug 的详细列表，请参阅 SDK 更改日志文档
建议的版本
2\.x.x 版本下支持 .NET SDK 的不同子版本。 此 SDK 版本 2.x 将于 2024 年 8 月 31 日停用，需要在该日期前将 SDK 更新到版本 3。 Azure Cosmos DB .NET SDK 版本 3 包括更新的功能和改进的性能。 建议按说明迁移到 Azure Cosmos DB .NET SDK 版本 3。
FAQ
如何收到即将停用的 SDK 的通知？
Microsoft将在停用 SDK 的支持结束前提供 12 个月的提前通知，以便顺利过渡到受支持的 SDK。 我们将通过各种通信渠道通知你：Azure门户、Azure更新，以及直接与分配的服务管理员通信。
12 个月期间使用 to-be停用的 Azure Cosmos DB SDK 创作应用程序？
是的，你将能够在 12 个月的通知期内使用 to-be停用的 Azure Cosmos DB SDK 创作、部署和修改应用程序。 建议在 12 个月的通知期内迁移到较新的受支持版本的 Azure Cosmos DB SDK，视情况而定。
停用日期后，使用不支持的 Azure Cosmos DB SDK 的应用程序会发生什么情况？
停用日期后，Azure Cosmos DB将不再进行 bug 修复、添加新功能或为停用的 SDK 版本提供支持。 如果不想升级，则从已停用版本的 SDK 发送的请求将继续由Azure Cosmos DB服务提供服务。
哪些 SDK 版本将包含最新功能和更新？
新功能和更新将仅添加到最新的受支持的主要 SDK 版本的最新次要版本。 建议始终使用最新版本，以充分利用新功能、性能改进和 bug 修补程序。 如果使用的是旧版非停用版本的 SDK，则对Azure Cosmos DB的请求仍然有效，但你无权访问任何新功能。
如果无法在截止日期之前更新应用程序，该怎么办？
我们建议尽早升级到最新 SDK。 SDK 标记为要停用之后，你将有 12 个月的时间来更新应用程序。 如果无法按停用日期更新，则从已停用版本的 SDK 发送的请求将继续由Azure Cosmos DB提供服务，因此正在运行的应用程序将继续正常运行。 但是，Azure Cosmos DB将不再进行 bug 修复、添加新功能或为停用的 SDK 版本提供支持。
如果你有支持计划并需要技术支持，请创建支持工单以联系我们。
如何请求将功能添加到 SDK 或连接器？
新功能并不总是立即添加到每个 SDK 或连接器中。 如果你想添加的功能不受支持，请在我们的社区论坛提出反馈。
另见
若要了解有关Azure Cosmos DB的详细信息，请参阅 Microsoft Azure Cosmos DB 服务页。