ITableEntity Schnittstelle

Definition

Namespace:

Microsoft.Azure.Cosmos.Table

Assembly:

Microsoft.Azure.Cosmos.Table.dll

Paket:

Microsoft.Azure.Cosmos.Table v1.0.8

Eine Schnittstelle, die für Tabellenentitätstypen erforderlich ist. Die ITableEntity-Schnittstelle deklariert Getter- und Setter-Methoden für die erforderlichen Entitätseigenschaften sowie die Methoden ReadEntity(IDictionary<String,EntityProperty>, OperationContext) und WriteEntity(OperationContext) für die Serialisierung und Deserialisierung aller Entitätseigenschaften, die ein Eigenschaftenwörterbuch verwenden. Erstellen Sie Klassen, die ITableEntity implementieren, um das Speicher, Abrufen, Serialisieren und Deserialisieren von Eigenschaften anzupassen und eine zusätzliche benutzerdefinierte Logik für eine Tabellenentität bereitzustellen.

public interface ITableEntity

type ITableEntity = interface

Public Interface ITableEntity

Abgeleitet

Microsoft.Azure.Cosmos.Table.DynamicTableEntity

Microsoft.Azure.Cosmos.Table.TableEntity

Hinweise

Die Speicherclientbibliothek enthält zwei Implementierungen von ITableEntity, die ein einfaches Zugreifen auf und Serialisieren von Eigenschaften bereitstellen:

DynamicTableEntity implementiert ITableEntity und bietet ein einfaches Eigenschaftenwörterbuch zum Speichern und Abrufen von Eigenschaften. Verwenden Sie DynamicTableEntity für den einfachen Zugriff auf Entitätseigenschaften, wenn nur eine Teilmenge der Eigenschaften zurückgegeben wird (z. B. durch eine select-Klausel in einer Abfrage) oder für Szenarien, in denen Ihre Abfrage mehrere Entitätstypen mit verschiedenen Eigenschaften zurückgeben kann. Dieser Typ kann auch verwendet werden, um Massentabellenaktualisierungen von heterogenen Entitäten ohne Verlust von Eigenschaftsinformationen durchzuführen.

TableEntity ist eine Implementierung von ITableEntity, die ein reflektionsbasiertes Serialisierungs- und Deserialisierungsverhalten in den Methoden ReadEntity(IDictionary<String,EntityProperty>, OperationContext) und WriteEntity(OperationContext) verwendet. TableEntity-abgeleitete Klassen mit Methoden, die einer Konvention für Typen und Benennungen folgen, werden automatisch serialisiert und deserialisiert. TableEntity-abgeleitete Klassen müssen auch eine get-fähige und set-fähige öffentliche Eigenschaft eines Typs bereitstellen, der vom Microsoft Azure-Tabellendienst unterstützt wird.

Eigenschaften

ETag	Ruft das aktuelle ETag der Entität ab oder legt es fest. Legt diesen Wert auf "*" fest, um eine Entität als Teil eines Updatevorgangs blind zu überschreiben.
PartitionKey	Ruft den Partitionsschlüssel der Entität ab oder legt ihn fest.
RowKey	Ruft den Zeilenschlüssel der Entität ab oder legt ihn fest.
Timestamp	Ruft den Zeitstempel der Entität ab oder legt ihn fest.

Methoden

ReadEntity(IDictionary<String,EntityProperty>, OperationContext)	Füllt die Eigenschaften der Entität aus den EntityProperty-Datenwerten in das properties-Wörterbuch.
WriteEntity(OperationContext)	Serialisiert IDictionary<TKey,TValue> mit Eigenschaftsnamen, die EntityProperty-Datenwerten aus der Entitätsinstanz zugeordnet sind.