Reflektionsanbieter (WCF Data Services)

Zusätzlich zu Daten aus einem Datenmodell über das Entity Framework kann WCF Data Services Daten verfügbar machen, die in einem entitätsbasierten Modell nicht streng definiert sind. Der Reflexionsanbieter macht Daten in Klassen verfügbar, die Typen zurückgeben, die die IQueryable<T>-Schnittstelle implementieren. WCF Data Services verwendet Reflexion, um ein Datenmodell für diese Klassen abzuleiten, und kann adressenbasierte Abfragen nach Ressourcen in LINQ (Language Integrated Query)-basierte Abfragen nach den verfügbar gemachten IQueryable<T>-Typen übersetzen.

Der Reflektionsanbieter unterstützt Typhierarchien. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Datendiensts mithilfe des Reflektionsanbieters (WCF Data Services).

Herleiten des Datenmodells

Wenn Sie den Datendienst erstellen, leitet der Anbieter das Datenmodell mithilfe der Reflektion her. In der folgenden Liste wird gezeigt, wie der Reflektionsanbieter das Datenmodell herleitet:

• Entitätscontainer - die Klasse, die die Daten als Eigenschaften verfügbar macht, die eine IQueryable<T>-Instanz zurückgeben. Wenn Sie ein reflektionsbasiertes Datenmodell adressieren, stellt der Entitätscontainer den Stamm des Diensts dar. Es wird nur eine Entitätscontainerklasse für einen angegebenen Namespace unterstützt.

• Entitätenmengen - Eigenschaften, die IQueryable<T>-Instanzen zurückgeben, werden als Entitätenmengen behandelt. Entitätenmengen werden in der Abfrage direkt als Ressourcen adressiert. Nur eine Eigenschaft im Entitätscontainer kann eine IQueryable<T>-Instanz eines angegebenen Typs zurückgeben.

• Entitätstypen - der Typ T der IQueryable<T>, den die Entitätenmenge zurückgibt. Klassen, die Teil einer Vererbungshierarchie sind, werden vom Reflektionsanbieter in eine entsprechende Entitätstyphierarchie übersetzt.

• Entitätsschlüssel - jede Datenklasse, die ein Entitätstyp ist, muss über eine Schlüsseleigenschaft verfügen. Dieser Eigenschaft wird das DataServiceKeyAttribute-Attribut ([DataServiceKeyAttribute]) zugewiesen.

  Hinweis

  Sie sollten das DataServiceKeyAttribute-Attribut nur auf eine Eigenschaft anwenden, mit der eine Instanz des Entitätstyps eindeutig identifiziert werden kann.Dieses Attribut wird ignoriert, wenn es auf eine Navigationseigenschaft angewendet wird.

• Entitätstypeigenschaften - im Gegensatz zum Entitätsschlüssel behandelt der Reflektionsanbieter die zugänglichen, nicht indizierten Eigenschaften einer Klasse, die ein Entitätstyp ist, wie folgt:

  • Wenn die Eigenschaft einen primitiven Typ zurückgibt, dann wird davon ausgegangen, dass die Eigenschaft eine Eigenschaft eines Entitätstyps ist.

  • Wenn die Eigenschaft einen Typ zurückgibt, der auch ein Entitätstyp ist, dann wird davon ausgegangen, dass die Eigenschaft eine Navigationseigenschaft ist, die das "1"-Ende einer n:1- oder 1:1-Beziehung darstellt.

  • Wenn die Eigenschaft einen IEnumerable<T> eines Entitätstyps zurückgibt, dann wird davon ausgegangen, dass die Eigenschaft eine Navigationseigenschaft ist, die das "n"-Ende einer 1:n- oder m:n-Beziehung darstellt.

  • Wenn es sich beim Rückgabetyp der Eigenschaft um einen Werttyp handelt, stellt die Eigenschaft einen komplexen Typ dar.

Datentypzuordnung

Wenn ein Datenmodell aus .NET Framework-Klassen abgeleitet wird, werden die primitiven Typen im Datenmodell .NET Framework-Datentypen wie folgt zugeordnet:

Aktivieren von Updates im Datenmodell

Der Reflektionsanbieter definiert eine IUpdatable-Schnittstelle, um Updates für Daten zu ermöglichen, die durch diese Art von Datenmodell verfügbar gemacht werden. Diese Schnittstelle weist den Datendienst an, wie Updates für die verfügbar gemachten Typen beibehalten werden. Die Entitätscontainerklasse muss die IUpdatable-Schnittstelle implementieren, um Updates für vom Datenmodell definierte Ressourcen zu aktivieren. Ein Beispiel für eine Implementierung der IUpdatable-Schnittstelle finden Sie unter Gewusst wie: Erstellen eines Datendiensts mit einer LINQ to SQL-Datenquelle (WCF Data Services).

Die IUpdatable-Schnittstelle erfordert, dass die folgenden Member implementiert werden, damit Updates mit dem Reflektionsanbieter zur Datenquelle weitergegeben werden können:

Behandeln von Parallelität

WCF Data Services unterstützt ein Modell vollständiger Parallelität, indem es Ihnen das Definieren eines Parallelitätstokens für eine Entität ermöglicht. Dieses Parallelitätstoken, das eine oder mehrere Eigenschaften der Entität beinhaltet, wird vom Datendienst verwendet, um zu bestimmen, ob eine Änderung in den angeforderten, aktualisierten oder gelöschten Daten aufgetreten ist. Wenn Tokenwerte die vom eTag in der Anforderung abgerufen wurden, sich von den aktuellen Werten der Entität unterscheiden, löst der Datendienst eine Ausnahme aus. Das ETagAttribute wird auf einen Entitätstyp angewendet, um im Reflektionsanbieter ein Parallelitätstoken zu definieren. Im Parallelitätstoken darf keine Schlüsseleigenschaft oder Navigationseigenschaft enthalten sein. Weitere Informationen finden Sie unter Aktualisieren des Datendiensts WCF Data Services.

Verwenden von LINQ to SQL mit dem Reflektionsanbieter

Da das Entity Framework standardmäßig systemintern unterstützt wird, ist es der empfohlene Datenanbieter zum Verwenden von relationalen Daten mit WCF Data Services. Sie können allerdings LINQ to SQL-Klassen mithilfe des Reflektionsanbieters mit einem Datendienst verwenden. Die Table<TEntity>-Resultsets, die von Methoden für den DataContext zurückgegeben werden, der vom LINQ to SQL-O/R-Designer (Object Relational Designer) generiert wurde, implementieren die IQueryable<T>-Schnittstelle. Dies ermöglicht dem Reflektionsanbieter, auf diese Methoden zuzugreifen und mit den generierten LINQ to SQL-Klassen Entitätsdaten aus SQL Server zurückzugeben. Da LINQ to SQL die IUpdatable-Schnittstelle nicht implementiert, müssen Sie jedoch eine partielle Klasse hinzufügen, die die vorhandene partielle DataContext-Klasse erweitert, um die IUpdatable-Implementierung hinzuzufügen. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Datendiensts mit einer LINQ to SQL-Datenquelle (WCF Data Services).

Siehe auch

Konzepte

Datendienstanbieter (WCF Data Services)