適用于 NoSQL 的 Azure Cosmos DB .NET SDK v2 for API:下載和版本資訊 (舊版)

適用于: NoSQL

連結
版本資訊 版本資訊
SDK 下載 NuGet
API 文件 .NET API 參考文件
範例 .NET 程式碼範例
開始使用 開始使用 Azure Cosmos DB .NET SDK 教學課程
Web 應用程式教學課程 使用 Azure Cosmos DB 進行 Web 應用程式開發
目前支援的架構 Microsoft .NET Framework 4.5

警告

在 2024 年 8 月 31 日,Azure Cosmos DB .NET SDK v2.x 將會淘汰;SDK 和使用 SDK 的所有應用程式都可以繼續運作;Azure Cosmos DB 只會停止提供此 SDK 的進一步維護和支援。 建議您遷移至最新版本的 .NET SDK v3 SDK。

注意

如果您使用 .NET Framework,請參閱以 .NET Standard 為目標的最新 3.x 版 .NET SDK

版本歷程記錄

版本歷程記錄會在 Azure Cosmos DB .NET SDK 來源存放庫中維護。 如需每個版本中功能發行和已修正錯誤的詳細清單,請參閱 SDK 變更記錄文件

因為第 3 版 Azure Cosmos DB .NET SDK 包含更新功能和改善效能,所以這個 SDK 的 2.x 版本將會在 2024 年 8 月 31 日淘汰。 您必須在該日期之前將 SDK 更新為第 3 版。 建議您遵循移轉至 Azure Cosmos DB .NET SDK 第 3 版的指示

.NET SDK 的不同子版本可以在 2.x.x 版本底下取得。 建議的最低版本是 2.18.0

已知問題

以下是會影響建議的最低版本的任何已知問題清單:

問題 影響 降低 追蹤連結

常見問題集

我如何獲知 SDK 將要停用?

Microsoft 會在停用 SDK 支援結束的 12 個月前事先通知,以利順暢轉換至支援的 SDK。 我們會透過各種通訊管道通知您:Azure 入口網站、Azure 更新,以及直接與受指派服務系統管理員通訊。

在 12 個月的期間內,我是否可以使用「即將」停用的 Azure Cosmos DB SDK 來撰寫應用程式?

可以,在 12 個月的通知期內,您可以使用即將停用的 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 服務頁面。