ADO.NET Data Services-Systemabfrageoptionen

Die Optionen für URI-Systemabfragen stellen die Direktiven dar, die in ADO.NET Data Services verwendet werden, um die Antwort auf eine Anforderung zu steuern. In den folgenden Tabellen werden die von ADO.NET Data Services unterstützten Optionen zusammengefasst.

Zusammenfassung der unterstützten Systemabfrageoptionen

In den folgenden Tabellen werden die Abfrageoptionen aufgeführt und beschrieben, die von ADO.NET Data Services-URIs verwendet werden. Diese Optionen können zum Begrenzen oder Sortieren der Ergebnisse an Abfragen angehängt werden.

Option	Beschreibung
$expand	Wird verwendet, um festzulegen, dass Mengen, auf die von der Zielmenge verwiesen wird, inline und nicht als verzögerter Inhalt zurückgegeben werden.
$filter	Gibt nur die Elemente der Zielmenge zurück, die das angegebene Prädikat erfüllen.
$orderby	Sortiert die Zielentitätenmenge auf- oder absteigend.
$skip	Überspringt n Elemente im Ziel, und gibt das Element an der Stelle n+1 und die bis zum Ende der Menge folgenden Elemente zurück.
$top	Gibt die ersten n Elemente der Zielmenge zurück.

Wenn eine Abfrageoption in einem URI für eine Ressource enthalten ist, die den entsprechenden Vorgang nicht unterstützt, wird der Antwortcode "400 Bad Request" zurückgegeben.

Anwendung der Option zur Abfragereihenfolge

Wenn in ADO.NET Data Services eine Abfragereihenfolge angewendet wird, erfolgt dies gemäß der in der folgenden Liste angegebenen Reihenfolge. Wenn eine der Optionen nicht angegeben ist, wird der entsprechende Schritt übersprungen.

$filter. Begrenzt die Menge der zurückgegebenen Elemente.

$orderby. Legt die Reihenfolge der zurückgegebenen Elemente fest.

$skip. Überspringt eine bestimmte Anzahl an Elementen.

$top. Begrenzt die Anzahl der zurückgegebenen Elemente.

$expand. Gibt zusätzlich zu den Basiselementen verwandte Inhalte zurück.

Der URI http://www.example.com/service.svc/Orders?$orderby=ID&$top=10&$skip=10 gibt an, dass aus der Liste der Bestellungen die Bestellungen 11 bis 21 nach den ID-Eigenschaftswerten sortiert zurückgegeben werden.

Für verschiedene URIs unterstützte Systemabfrageoptionen

In den folgenden Tabellen werden die Abfrageoptionen aufgeführt, die von den einzelnen URI-Syntaxtypen unterstützt oder nicht unterstützt werden. Auf jedes Syntaxbeispiel folgt eine Tabelle, in der die für diese Syntax unterstützten Optionen aufgelistet sind.

URI: serviceName/<EntitySet>

Option	Unterstützt	Hinweise
$expand	Ja	Gibt eine Entitätenmenge zurück.
$filter	Ja	Gibt eine Entitätenmenge zurück.
$orderby	Ja	Gibt eine Entitätenmenge zurück.
$skip	Ja	Gibt eine Entitätenmenge zurück.
$top	Ja	Gibt eine Entitätenmenge zurück.

URI: serviceName/<ResourceSet>(KeyPredicate)

Option	Unterstützt	Hinweise
$expand	Ja	Gibt von den angegebenen Bedingungen identifizierte Ressourcen zurück. In der Regel handelt es sich dabei um Daten, die mit der Basisressourcenmenge in Beziehung stehen.
$filter	Ja	Gibt die Ressource zurück, wenn die Filterbedingung erfüllt ist. Andernfalls wird der Antwortcode "404 Resource Not Found" zurückgegeben.
$orderby	Nein
$skip	Nein
$top	Nein

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceComplexType>

Option	Unterstützt	Hinweise
$expand	Ja	Komplexe Typen werden immer erweitert. Dies gilt auch dann, wenn $expand nicht im URI vorhanden ist.
$filter	Ja	Gibt eine Instanz eines komplexen Typs zurück, wenn die Filterbedingung erfüllt ist. Andernfalls wird der Antwortcode "404 Resource Not Found" zurückgegeben.
$orderby	Nein
$skip	Nein
$top	Nein

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceComplexType>/<ResourceProperty>

Option	Unterstützt	Hinweise
$expand	Ja	Komplexe Typen werden immer erweitert. Dies gilt auch dann, wenn $expand nicht im URI vorhanden ist. Wenn es sich nicht um einen komplexen Typ handelt, verfügt die Ressourceneigenschaft über keine eigenen erweiterbaren Eigenschaften.
$filter	Nein
$orderby	Nein
$skip	Nein
$top	Nein

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceProperty>

Option	Unterstützt	Hinweise
$expand	Ja	Komplexe Typen werden immer erweitert. Dies gilt auch dann, wenn $expand nicht im URI vorhanden ist. Wenn es sich nicht um einen komplexen Typ handelt, verfügt die Ressourceneigenschaft über keine eigenen erweiterbaren Eigenschaften.
$filter	Nein
$orderby	Nein
$skip	Nein
$top	Nein

URI: serviceName/<Resource Set>(KeyPredicate)/<ResourceNavigationProperty>

In der folgenden Tabelle werden die Abfrageoptionen für die Navigationseigenschaften des vorherigen Beispiels beschrieben, die einer 1:1- oder m:1-Beziehung entsprechen:

Option	Unterstützt	Hinweise
$expand	Ja	Gibt eine Instanz eines Entitätstyps zurück.
$filter	Ja	Gibt eine Instanz eines Entitätstyps zurück.
$orderby	Nein
$skip	Nein
$top	Nein

In der folgenden Tabelle werden die Abfrageoptionen für die Navigationseigenschaften beschrieben, die einer 1:n- oder m:n-Beziehung entsprechen:

Option	Unterstützt	Hinweise
$expand	Ja	Gibt eine Entitätenmenge zurück.
$filter	Ja	Gibt eine Entitätenmenge zurück.
$orderby	Ja	Gibt eine Entitätenmenge zurück.
$skip	Ja	Gibt eine Entitätenmenge zurück.
$top	Ja	Gibt eine Entitätenmenge zurück.

Siehe auch

Konzepte

Abfrageoptionen von ADO.NET Data Services
Parameter von Dienstvorgängen (ADO.NET Data Services-Framework)