Konfigurieren des Datendiensts (WCF Data Services)

Mit WCF Data Services können Sie Datendienste erstellen, die Open Data Protocol (OData)-Feeds verfügbar machen. Die Daten dieser Feeds können aus einer Vielzahl von Datenquellen stammen. WCF Data Services macht diese Daten mithilfe von Datenanbietern als OData-Feed verfügbar. Zu diesen Anbietern zählen ein Entity Framework-Anbieter, ein Reflektionsanbieter und ein Schnittstellensatz für benutzerdefinierte Datendienstanbieter. Die Anbieterimplementierung definiert das Datenmodell für den Dienst. Weitere Informationen finden Sie unter Datendienstanbieter (WCF Data Services).

In WCF Data Services ist ein Datendienst eine Klasse, die von der DataService<T>-Klasse erbt. Dabei ist der Typ des Datendiensts der Entitätscontainer des Datenmodells. Dieser Entitätscontainer verfügt über mindestens eine Eigenschaft, die einen IQueryable<T> zurückgibt und die für den Zugriff auf Entitätenmengen im Datenmodell verwendet wird.

Das Verhalten des Datendiensts wird durch die Member der DataServiceConfiguration-Klasse definiert, und durch Member der DataServiceBehavior-Klasse, auf die von der DataServiceBehavior-Eigenschaft der DataServiceConfiguration-Klasse zugegriffen wird. Die DataServiceConfiguration-Klasse wird für die InitializeService-Methode angegeben, die vom Datendienst implementiert wird, wie im folgenden Northwind-Dienst, den Sie beim Ausführen des Schnellstarts erstellen:

Public Class Northwind
    Inherits DataService(Of NorthwindEntities)

    ' This method is called only once to initialize service-wide policies.
    Public Shared Sub InitializeService(ByVal config As DataServiceConfiguration)
        ' Grant only the rights needed to support the client application.
        config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead _
             Or EntitySetRights.WriteMerge _
             Or EntitySetRights.WriteReplace)
        config.SetEntitySetAccessRule("Order_Details", EntitySetRights.AllRead _
            Or EntitySetRights.AllWrite)
        config.SetEntitySetAccessRule("Customers", EntitySetRights.AllRead)
    End Sub
End Class

public class Northwind : DataService<NorthwindEntities>
{
    // This method is called only once to initialize service-wide policies.
    public static void InitializeService(DataServiceConfiguration config)
    {
        // Grant only the rights needed to support the client application.
        config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead
             | EntitySetRights.WriteMerge
             | EntitySetRights.WriteReplace);
        config.SetEntitySetAccessRule("Order_Details", EntitySetRights.AllRead
            | EntitySetRights.AllWrite);
        config.SetEntitySetAccessRule("Customers", EntitySetRights.AllRead);
        config.DataServiceBehavior.MaxProtocolVersion =
            System.Data.Services.Common.DataServiceProtocolVersion.V3;
    }
}

Konfigurationseinstellungen des Datendiensts

Mit der DataServiceConfiguration-Klasse können Sie das folgende Datendienstverhalten angeben:

Minimale Ressourcenzugriffsrechte

In der folgenden Tabelle sind die minimalen Rechte für Entitätenmengen aufgelistet, die gewährt werden müssen, um einen bestimmten Vorgang auszuführen. Pfadbeispiele basieren auf dem Northwind-Datendienst, der beim Ausführen desSchnellstarts erstellt wird. Da sowohl die EntitySetRights-Enumeration als auch die ServiceOperationRights-Enumeration mit dem FlagsAttribute definiert werden, können Sie mithilfe eines logischen OR-Operators mehrere Berechtigungen für eine Entitätenmenge oder einen Vorgang angeben. Weitere Informationen finden Sie unter Vorgehensweise: Aktivieren des Zugriffs auf den Datendienst (WCF Data Services).

1 In diesem Beispiel stellt Address eine komplexe Typeigenschaft der Customers-Entität dar, die über eine Eigenschaft mit dem Namen StreetAddress verfügt. In dem für die Northwind-Datendienste verwendeten Modell ist dieser komplexe Typ nicht explizit definiert. Wenn das Datenmodell mit dem Entity Framework-Anbieter definiert wird, können Sie einen solchen komplexen Typ mithilfe der Entity Data Model-Tools definieren. Weitere Informationen finden Sie unter How to: Create and Modify Complex Types (Entity Data Model Tools).

2 Dieser URI wird unterstützt, wenn eine ein Binary Large Object (BLOB) zurückgebende Eigenschaft als Medienressource definiert wird, die zu einer Entität gehört, die ein Medienlinkeintrag ist (in diesem Fall Customers). Weitere Informationen finden Sie unter Streaminganbieter (WCF Data Services).

Versionsanforderungen

Für die folgenden Konfigurationsverhalten eines Datendiensts ist Version 3 des OData-Protokolls oder eine höhere Version erforderlich:

• Unterstützung für den Einschluss von Beziehungslinkelementen in den Antwortfeed.

• Unterstützung für die Abfrageoperatoren any und all.

• Unterstützung für die Definition von Dienstaktionen und -funktionen.

• Unterstützung für räumliche Datentypen.

• Unterstützung für Vokabulare durch Definieren von Datenmodellanmerkungen.

• Unterstützung für das Deaktivieren der Datenmodellvalidierung für eine $metadata-Endpunktanforderung.

Für die folgenden Konfigurationsverhalten eines Datendiensts ist Version 2 des OData-Protokolls oder eine höhere Version erforderlich:

• Die Unterstützung für count-Anforderungen und Abfrageprojektion erfordert Version 2.0 oder höher des OData-Protokolls.

• Die Unterstützung für die $select-Abfrageoption für Projektionen erfordert Version 2.0 oder höher des OData-Protokolls.

Weitere Informationen finden Sie unter Datendienst-Versionskontrolle (WCF Data Services).

Siehe auch

Konzepte

Hosten des Datendiensts (WCF Data Services)

Andere Ressourcen

Datendienst (WCF Data Services)