ITableEntity Interface

Définition

Espace de noms:

Microsoft.Azure.Cosmos.Table

Assembly:

Microsoft.Azure.Cosmos.Table.dll

Paquet:

Microsoft.Azure.Cosmos.Table v1.0.8

Interface requise pour les types d'entités de table. L'interface ITableEntity déclare les méthodes Get et Set pour les propriétés d'entités obligatoires, et les méthodes ReadEntity(IDictionary<String,EntityProperty>, OperationContext) et WriteEntity(OperationContext) pour la sérialisation et la désérialisation de toutes les propriétés d'entités à l'aide d'un dictionnaire de propriétés. Créez des classes implémentant ITableEntity pour personnaliser le stockage, la récupération, la sérialisation et la désérialisation des propriétés, ainsi que pour fournir une logique personnalisée supplémentaire pour une entité de table.

public interface ITableEntity

type ITableEntity = interface

Public Interface ITableEntity

Dérivé

Microsoft.Azure.Cosmos.Table.DynamicTableEntity

Microsoft.Azure.Cosmos.Table.TableEntity

Remarques

La bibliothèque cliente de stockage comprend deux implémentations de ITableEntity qui fournissent la sérialisation et l'accès aux propriétés :

DynamicTableEntity implémente ITableEntity et fournit un dictionnaire de propriétés simple pour stocker et récupérer des propriétés. Utilisez un objet DynamicTableEntity pour un accès simple aux propriétés d'entités quand seule une partie des propriétés est retournée (par exemple par une clause select dans une requête) ou pour les scénarios où votre requête peut retourner plusieurs types d'entités avec des propriétés différentes. Vous pouvez également utiliser ce type pour effectuer des mises à jour de tables en bloc d'entités hétérogènes sans perdre les informations sur les propriétés.

TableEntity est une implémentation de ITableEntity qui utilise le comportement de sérialisation et de désérialisation basée sur la réflexion dans ses méthodes ReadEntity(IDictionary<String,EntityProperty>, OperationContext) et WriteEntity(OperationContext). TableEntity- les classes dérivées avec des méthodes qui suivent une convention pour les types et le nommage sont sérialisées et désérialisées automatiquement. TableEntityLes classes dérivées doivent également fournir une propriété publique get-able et set-able d’un type pris en charge par le service Microsoft Azure Table.

Propriétés

ETag	Obtient ou définit l'ETag actuel de l'entité. Définissez cette valeur sur « * » pour remplacer à l'aveugle une entité dans le cadre d'une opération de mise à jour.
PartitionKey	Obtient ou définit la clé de partition de l'entité.
RowKey	Obtient ou définit la clé de ligne de l'entité.
Timestamp	Obtient ou définit l'horodateur de l'entité.

Méthodes

ReadEntity(IDictionary<String,EntityProperty>, OperationContext)	Remplit les propriétés de l'entité à partir des valeurs de données EntityProperty du dictionnaire properties.
WriteEntity(OperationContext)	Sérialise les noms de propriétés IDictionary<TKey,TValue> mappées aux valeurs de données EntityProperty à partir de l'instance d'entité.