本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
適用於 .NET 的 Amazon QLDB 驅動程式
重要
支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL
若要使用 分類帳中的資料，您可以使用 AWS 提供的驅動程式，從 Microsoft .NET 應用程式連線至 Amazon QLDB。驅動程式以 .NET Standard 2.0 為目標。更具體地說，它支援 .NET Core (LTS) 2.1+ 和 .NET Framework 4.5.2+。如需相容性的詳細資訊，請參閱 Microsoft 文件網站上的 .NET Standard
我們強烈建議使用 Ion 物件映射器，完全略過在 Amazon Ion 類型和原生 C# 類型之間手動轉換的需求。
下列主題說明如何開始使用適用於 .NET 的 QLDB 驅動程式。
驅動程式資源
如需 .NET 驅動程式支援功能的詳細資訊，請參閱下列資源：
先決條件
開始使用適用於 .NET 的 QLDB 驅動程式之前，您必須執行下列動作：
-
請遵循 中的 AWS 設定指示存取 Amazon QLDB。這包含下列項目：
-
註冊 AWS。
-
建立具有適當 QLDB 許可的使用者。
-
授予開發的程式設計存取權。
-
-
（選用） 安裝您選擇的整合開發環境 (IDE)，例如 Visual Studio、Visual Studio for Mac 或 Visual Studio Code。您可以從 Microsoft Visual Studio
網站下載這些項目。 -
設定 的開發環境AWS SDK for .NET
： -
設定您的 AWS 登入資料。建議您建立共用登入資料檔案。
如需說明，請參閱《 AWS SDK for .NET 開發人員指南》中的使用 AWS 登入資料檔案設定登入資料。
-
設定您的預設值 AWS 區域。若要了解如何進行，請參閱AWS 區域 選取。
如需可用區域的完整清單，請參閱 中的 Amazon QLDB 端點和配額AWS 一般參考。
-
接下來，您可以設定基本範例應用程式並執行簡短程式碼範例，或者您可以在現有的 .NET 專案中安裝驅動程式。
安裝
使用 NuGet 套件管理員安裝適用於 .NET 的 QLDB 驅動程式。我們建議您使用 Visual Studio 或您選擇的 IDE 來新增專案相依性。驅動程式套件名稱為 Amazon.QLDB.Driver
例如，在 Visual Studio 中，開啟工具功能表上的 NuGet Package Manager 主控台。然後，在PM>提示中輸入下列命令。
PM>Install-Package Amazon.QLDB.Driver
安裝驅動程式也會安裝其相依性，包括 AWS SDK for .NET 和 Amazon Ion 套件。
安裝 Ion 物件映射器
適用於 .NET 的 QLDB 驅動程式 1.3.0 版推出支援，以接受和傳回原生 C# 資料類型，而無需使用 Amazon Ion。若要使用此功能，請將下列套件新增至您的專案。
-
Amazon.QLDB.Driver.Serialization
– 可將 Ion 值映射至 C# 舊 CLR 物件 (POCO) 的程式庫，反之亦然。此 Ion 物件映射器可讓您的應用程式直接與原生 C# 資料類型互動，而不需要使用 Ion。如需如何使用此程式庫的簡短指南，請參閱 GitHub 儲存庫 中的 SERIALIZATION.md 檔案 awslabs/amazon-qldb-driver-dotnet。
若要安裝此套件，請輸入下列命令。
PM>Install-Package Amazon.QLDB.Driver.Serialization
如需如何在分類帳上執行基本資料交易的簡短程式碼範例，請參閱 技術指南參考。
