AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

DynamoDB 属性

此部分介绍了对象持久化模型提供的属性，您可以通过这些属性将您自己的类和属性映射到 DynamoDB 表和属性。

DynamoDBGlobalSecondaryIndexHashKey

将类属性映射到全局二级索引的分区键。如果您需要对全局二级索引执行Query操作，请使用此属性。

DynamoDBGlobalSecondaryIndexRangeKey

将类属性映射到全局二级索引的排序键。如果您需要对全局二级索引执行Query操作并想使用索引排序键优化结果，请使用此属性。

DynamoDBHashKey

将类属性映射到表的主键的分区键。主键属性不能为集合类型。

以下 C# 代码示例将 Book 类映射到 ProductCatalog 表，将 Id 属性映射到表的主键分区键。

[DynamoDBTable("ProductCatalog")] 
   public class Book { 
   [DynamoDBHashKey] 
   public int Id { get; set; }
  
   // Additional properties go here. 
}

DynamoDBIgnore

指示应忽略相关联的属性。如果您不想保存任何类属性，可以添加此属性让 DynamoDBContext 在表中保存对象时不要包含此属性。

DynamoDBLocalSecondaryIndexRangeKey

将类属性映射到local secondary index的排序键。如果您需要对local secondary index执行Query操作并想使用索引排序键优化结果，请使用此属性。

DynamoDBProperty

将类属性映射到表属性。如果类属性映射到同名表属性，您就无需指定此属性。然而，如果名称不同，您就可以使用此标签提供映射。在以下 C# 语句中，DynamoDBProperty 将 BookAuthors 属性映射到表中的 Authors 属性。

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

DynamoDBContext 会使用此映射信息在将对象数据保存到对应的表中时创建 Authors 属性。

DynamoDBRenamable

为类属性指定替代名称。如果您要编写用于将任意数据映射到 DynamoDB 表的自定义转换器，且类属性的名称不同于表属性，则该操作十分有用。

DynamoDBRangeKey

将类属性映射到表的主键的排序键。如果表具有复合主键（分区键和排序键），您就必须在类映射中同时指定 DynamoDBHashKey 和 DynamoDBRangeKey 属性。

例如，样本表 Reply 的主键由 Id 分区键和 Replenishment 排序键共同构成。下面的 C# 代码示例将 Reply 类映射到 Reply 表。类定义中也会指明有这两个属性映射到主键。

有关样本表的更多信息，请参阅为 DynamoDB 中的代码示例创建表和加载数据。

[DynamoDBTable("Reply")] 
public class Reply { 
   [DynamoDBHashKey] 
   public int ThreadId { get; set; }
   [DynamoDBRangeKey]
   public string Replenishment { get; set; }
   // Additional properties go here. 
}

DynamoDBTable

确定类映射到的 DynamoDB 中的目标表。例如，以下 C# 代码示例将 Developer 类映射到 DynamoDB 中的 People 表。

[DynamoDBTable("People")] 
public class Developer { ...}

此属性可被继承或覆盖。

您可以添加可选参数 LowerCamelCaseProperties 请求 DynamoDB 在将对象保存到表中时将属性名称的第一个字母变成小写（如以下 C# 代码示例所示）。

[DynamoDBTable("People", LowerCamelCaseProperties=true)] 
public class Developer { 
   string DeveloperName;
   ...}

保存 Developer 类的实例时，DynamoDBContext 会将 DeveloperName 属性保存为 developerName。

DynamoDBVersion

确定类属性以便存储项目版本号。有关版本控制的更多信息，请参阅乐观锁（使用版本号）与 DynamoDB（使用适用于 .NET 的 AWS 开发工具包对象持久化模型）配合使用。