。 NET：物件持續性模型

所以此 AWS SDK for .NET 提供物件持續性模型，可讓您將用戶端類別對應至 Amazon DynamoDB 表格。然後每個物件執行個體會映射至相對應資料表中的某個項目。為了將用戶端物件儲存至資料表，物件持久性模型會提供 DynamoDBContext 類別 (即 DynamoDB 的進入點)。此類別為您提供與 DynamoDB 的連線，並可讓您存取資料表、執行各種CRUD作業以及執行查詢。

物件持久性模型提供了一組屬性，可將用戶端類別映射到資料表，並將屬性/欄位映射至資料表屬性。

以下範例會示範物件持久性模型的運作方式。它會從 ProductCatalog 資料表開始作業。它將 Id 作為主索引鍵。

ProductCatalog(Id, ...)

假設您的 Book 類別具有 Title、ISBN 以及 Authors 屬性。您可以透過新增物件持久性模型所定義的屬性，將 Book 類別映射至 ProductCatalog 資料表中，如下列 C# 程式碼範例所示。

[DynamoDBTable("ProductCatalog")]
  public class Book
  {
    [DynamoDBHashKey]
    public int Id { get; set; }

    public string Title { get; set; }
    public int ISBN { get; set; }

    [DynamoDBProperty("Authors")]
    public List<string> BookAuthors { get; set; }

    [DynamoDBIgnore]
    public string CoverPage { get; set; }
  }

在上述範例中，DynamoDBTable 屬性會將 Book 類別映射至 ProductCatalog 資料表。

物件持久性模型支援類別屬性與資料表屬性之間的明確映射和預設映射。

您不必映射每個類別屬性。您可以新增 DynamoDBIgnore 屬性來識別這些屬性。當您將 Book 執行個體儲存至資料表時，DynamoDBContext 不會包含 CoverPage 屬性。在擷取書籍執行個體時，它也不會傳回此屬性。

您可以對應的屬性。 NET原始類型，如 int 和字符串。只要提供適當的轉換器將任意資料映射至其中一種 DynamoDB 類型，您也可以映射任意資料類型。若要進一步了解如何映射任意類型，請參閱 將任意資料與 DynamoDB 資料對應 AWS SDK for .NET 對象持久性模型。

物件持久性模型支援樂觀鎖定。在更新操作期間，這可確保您擁有即將更新項目的最新副本。如需詳細資訊，請參閱使用具有 DynamoDB 的版本號碼進行樂觀鎖定 AWS SDK for .NET 對象持久性模型。

支援的資料類型

對象持久性模型支持一組原始。 NET資料類型、集合和任意資料類型。模型目前支援下列基本資料類型。

物件持續性模型也支援. NET集合類型。 DynamoDBContext能夠轉換具體集合類型和簡單的普通舊CLR對象（POCOs）。

下表摘要說明前述項目的對應。 NET動態支援類型的類型。

物件持久性模型也支援任意資料類型。不過，您必須提供轉換器程式碼，才能將複雜類型映射至 DynamoDB 類型。