你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ITableEntity 接口

定义

命名空间:

Microsoft.Azure.Cosmos.Table

程序集:

Microsoft.Azure.Cosmos.Table.dll

包:

Microsoft.Azure.Cosmos.Table v1.0.8

表实体类型所需的接口。 ITableEntity 接口声明必需实体属性的 getter 和 setter 方法，并声明 ReadEntity(IDictionary<String,EntityProperty>, OperationContext) 和 WriteEntity(OperationContext) 方法，用于使用属性字典序列化和反序列化所有实体属性。 创建实现 ITableEntity 的类，用于自定义属性存储、检索、序列化和反序列化，以及为表实体提供其他自定义逻辑。

public interface ITableEntity

type ITableEntity = interface

Public Interface ITableEntity

派生

Microsoft.Azure.Cosmos.Table.DynamicTableEntity

Microsoft.Azure.Cosmos.Table.TableEntity

注解

存储客户端库包括 ITableEntity 的两个实现，这些实现提供简单的属性访问和序列化：

DynamicTableEntity 实现 ITableEntity，并提供一个简单的属性字典用于存储和检索属性。 仅当返回属性的子集（例如，通过查询中的 select 子句）时，或者对于查询可返回多个包含不同属性的实体类型，才使用 DynamicTableEntity 对实体属性进行简单访问。 也可以使用此类型对异构实体执行批量更新，而不会丢失属性信息。

TableEntity 是 ITableEntity 的实现，该实现在其 ReadEntity(IDictionary<String,EntityProperty>, OperationContext) 和 WriteEntity(OperationContext) 方法中使用基于反射的序列化和反序列化行为。 TableEntity具有遵循类型和命名约定的方法的 派生类会自动序列化和反序列化。 TableEntity-派生类还必须提供 Microsoft Azure 表服务支持的类型的可获取且可设置的公共属性。

属性

ETag	获取或设置实体的当前 ETag。 在更新操作中，若要隐式覆盖实体，请将此值设置为“*”。
PartitionKey	获取或设置实体的分区键。
RowKey	获取或设置实体的行键。
Timestamp	获取或设置实体的时间戳。

方法

ReadEntity(IDictionary<String,EntityProperty>, OperationContext)	从 properties 字典中的 EntityProperty 数据值填充实体的属性。
WriteEntity(OperationContext)	从实体实例序列化映射到 IDictionary<TKey,TValue> 数据值的属性名称的 EntityProperty。