ITableEntity Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 ITableEntitytype ITableEntity = interfacePublic Interface ITableEntity- Dérivé
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 |
| 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é. |
S’applique à
Azure SDK for .NET