| Links | |
|---|---|
| 發行說明 | 發行說明 |
| SDK 下載 | NuGet |
| API 文件 | .NET API 參考文件 |
| 範例 | .NET 程式碼範例 |
| 開始使用 | 開始使用 Azure Cosmos DB .NET SDK |
| 目前支援的框架 | Microsoft .NET 框架 4.5 |
Warning
2024 年 8 月 31 日,Microsoft 正式退休了 Azure Cosmos DB .NET SDK v2.x。 SDK 及所有使用 SDK 的應用程式都能持續運作。 Microsoft 已不再為此 SDK 提供維護或支援。 建議您 移轉至最新版 的 .NET SDK v3 SDK。
Note
如果您使用 .NET Framework ,請參閱最新版本的 .NET SDK 3.x,該版本主要針對 .NET 標準。
發行歷史
Azure Cosmos DB .NET SDK 原始碼儲存庫負責維護發佈歷史。 如需每個版本中已修正功能版本和 Bug 的詳細清單,請參閱 SDK 變更記錄檔。
建議的版本
.NET SDK 的不同子版本可在 2.x.x 版本中提供。 Microsoft 已於 2024 年 8 月 31 日停用此 SDK 的 2.x 版本。 將您的 SDK 更新至版本 3。 Azure Cosmos DB .NET SDK 第 3 版包含更新的功能和改善的效能。 請依照指示遷移至 Azure Cosmos DB .NET SDK 版本 3。
FAQ
我將如何收到 SDK 退役的通知?
Microsoft 會在即將停用的 SDK 支援結束前提前 12 個月通知,協助您順利轉換至支援的 SDK。 您會透過以下通訊管道收到通知:Azure 入口網站、Azure 更新,以及直接與指定服務管理員的通訊。
我可以在 12 個月期間使用已停用的 to-beAzure Cosmos DB SDK 來撰寫應用程式嗎?
是的,您可以在 12 個月通知期內使用 to-be-retired Azure Cosmos DB SDK 來撰寫、部署及修改應用程式。 我們建議您在 12 個月通知期內,視情況遷移至支援更新的 Azure Cosmos DB SDK 版本。
在退休日期過後,使用不受支援的 Azure Cosmos DB SDK 的應用程式會發生什麼事?
在退役日期過後,Azure Cosmos DB 將不再提供錯誤修正、新增功能,或支援已停用的 SDK 版本。 如果您選擇不升級,Azure Cosmos DB 仍會繼續處理來自已停用版本 SDK 的請求。
哪些 SDK 版本會具備最新功能與更新?
新功能與更新僅會新增至最新支援的主要 SDK 版本的最新版本或次要版本。 建議您一律使用最新版本來利用新功能、效能改善和錯誤修正。 如果您使用的是舊版且未停用的 SDK,您對 Azure Cosmos DB 的請求仍然有效,但無法使用任何新功能。
如果我無法在截止日期前更新申請,該怎麼辦?
建議您儘早升級至最新的 SDK。 SDK 被標記為退休後,您有 12 個月的時間來更新您的應用程式。 如果您無法在退休日期前更新,Azure Cosmos DB 仍會繼續處理從已停用版本 SDK 發送的請求,讓您正在執行的應用程式能繼續運作。 但 Azure Cosmos DB 已不再修復錯誤、新增功能,或支援已停用的 SDK 版本。
如果您有支援方案並需要技術支援, 請提出支援票證以與我們連絡 。
我該如何要求將功能新增至 SDK 或連接器?
新功能並不一定會立即加入到每個 SDK 或連接器上。 如果有某項功能未被支援但你希望新增,歡迎在我們的 社群論壇留下意見。