ITableEntity Interface

Definição

Namespace:

Microsoft.Azure.Cosmos.Table

Assembly:

Microsoft.Azure.Cosmos.Table.dll

Pacote:

Microsoft.Azure.Cosmos.Table v1.0.8

Uma interface necessária para tipos de entidade de tabela. A interface ITableEntity declara os métodos getter e setter para as propriedades de entidade obrigatórias e os métodos ReadEntity(IDictionary<String,EntityProperty>, OperationContext) e WriteEntity(OperationContext) para serialização e desserialização de todas as propriedades de entidade usando um dicionário de propriedade. Criar classes que implementam ITableEntity para personalizar o armazenamento de propriedade, recuperação, serialização e desserialização e para fornecer mais lógica personalizada para uma entidade de tabela.

public interface ITableEntity

type ITableEntity = interface

Public Interface ITableEntity

Derivado

Microsoft.Azure.Cosmos.Table.DynamicTableEntity

Microsoft.Azure.Cosmos.Table.TableEntity

Comentários

A biblioteca de cliente de armazenamento inclui duas implementações de ITableEntity que fornecem acesso de propriedade simples e serialização:

DynamicTableEntity implementa ITableEntity e fornece um dicionário de propriedade simples para armazenar e recuperar propriedades. Use um DynamicTableEntity para acesso simples às propriedades de entidade apenas quando um subconjunto de propriedades são retornados (por exemplo, por uma cláusula select em uma consulta) ou para cenários em que a consulta pode retornar vários tipos de entidade com propriedades diferentes. Você também pode usar este tipo para executar atualizações da tabela em massa de entidades heterogêneas sem perder informações de propriedade.

TableEntity é uma implementação de ITableEntity que usa o comportamento de serialização e desserialização baseado em reflexão no seu ReadEntity(IDictionary<String,EntityProperty>, OperationContext) e WriteEntity(OperationContext) métodos. TableEntityClasses derivadas de com métodos que seguem uma convenção para tipos e nomenclatura são serializadas e desserializadas automaticamente. TableEntityClasses derivadas de também devem fornecer uma propriedade pública get-able e set-able de um tipo compatível com o serviço Tabela do Microsoft Azure.

Propriedades

ETag	Obtém ou define o ETag atual da entidade. Definir esse valor como “*” para substituir uma entidade como parte de uma operação de atualização.
PartitionKey	Obtém ou define a chave de partição da entidade.
RowKey	Obtém ou define a chave de linha da entidade.
Timestamp	Obtém ou define o carimbo de data/hora da entidade.

Métodos

ReadEntity(IDictionary<String,EntityProperty>, OperationContext)	Preenche as propriedades da entidade dos valores de dados do EntityProperty no dicionário properties.
WriteEntity(OperationContext)	Serializa o IDictionary<TKey,TValue> de nomes de propriedade mapeados para valores de dados EntityProperty da instância de entidade.