ITableEntity Interfaz

Definición

Espacio de nombres:

Microsoft.Azure.Cosmos.Table

Ensamblado:

Microsoft.Azure.Cosmos.Table.dll

Paquete:

Microsoft.Azure.Cosmos.Table v1.0.8

Interfaz necesaria para los tipos de entidad de tabla. La interfaz ITableEntity declara métodos Getter y Setter para las propiedades de entidad obligatorias, y métodos ReadEntity(IDictionary<String,EntityProperty>, OperationContext) y WriteEntity(OperationContext) para la serialización y la deserialización de todas las propiedades de entidad con un diccionario de propiedades. Crea clases que implementan ITableEntity para personalizar el almacenamiento de propiedades, la recuperación, la serialización y la deserialización, y para proporcionar lógica personalizada adicional para una entidad de tabla.

public interface ITableEntity

type ITableEntity = interface

Public Interface ITableEntity

Derivado

Microsoft.Azure.Cosmos.Table.DynamicTableEntity

Microsoft.Azure.Cosmos.Table.TableEntity

Comentarios

La biblioteca de cliente de almacenamiento incluye dos implementaciones de ITableEntity que proporcionan acceso a la propiedad simple y serialización:

DynamicTableEntity implementa ITableEntity y proporciona un diccionario de propiedades simples para almacenar y recuperar propiedades. Use a DynamicTableEntity para obtener acceso sencillo a las propiedades de entidad cuando solo se devuelva un subconjunto de propiedades (por ejemplo, mediante una cláusula SELECT de una consulta) o para escenarios en los que la consulta puede devolver varios tipos de entidad con propiedades diferentes. También puede utilizar este tipo para realizar de forma masiva actualizaciones de tabla de entidades heterogéneas sin perder información de la propiedad.

TableEntity es una implementación de ITableEntity que usa el comportamiento de serialización y deserialización basado en reflexión en sus métodos ReadEntity(IDictionary<String,EntityProperty>, OperationContext) y WriteEntity(OperationContext). TableEntityLas clases derivadas de con métodos que siguen una convención para los tipos y la nomenclatura se serializan y deserializan automáticamente. TableEntityLas clases derivadas también deben proporcionar una propiedad pública get-able y set-able de un tipo compatible con Microsoft Azure Table service.

Propiedades

ETag	Obtiene o establece el valor ETag actual de la entidad. Establezca este valor en '*' para sobrescribir directamente una entidad como parte de una operación de actualización.
PartitionKey	Obtiene o establece la clave de partición de la entidad.
RowKey	Obtiene o establece la clave de fila de la entidad.
Timestamp	Obtiene o establece la marca de tiempo de la entidad.

Métodos

ReadEntity(IDictionary<String,EntityProperty>, OperationContext)	Rellena las propiedades de la entidad a partir de valores de datos de EntityProperty del diccionario properties.
WriteEntity(OperationContext)	Serializa el objeto IDictionary<TKey,TValue> de nombres de propiedad asignados a valores de datos de EntityProperty de la instancia de entidad.