Freigeben über


ODATADetailLevel.ExpandClause Eigenschaft

Definition

Ruft die OData-Erweiterungsklausel ab oder legt sie fest. Wird verwendet, um zugeordnete Entitäten der Standard entität abzurufen.

public string ExpandClause { get; set; }
member this.ExpandClause : string with get, set
Public Property ExpandClause As String

Eigenschaftswert

Hinweise

Dies ist eine optionale OData-$expand-Ausdruckszeichenfolge (siehe OData-Spezifikation). Eigenschaften, die zugeordnete Entitäten enthalten, sind NULL, es sei denn, sie sind in einer ExpandClause enthalten. Insbesondere, wenn Sie eine Liste, Get oder Aktualisierung ausführen und keine ExpandClause angeben, sind alle zugeordneten Entitätseigenschaften NULL. Wenn Sie beispielsweise einen ListPools(DetailLevel, IEnumerable<BatchClientBehavior>) Vorgang ohne ExpandClause ausführen, ist die Statistics Eigenschaft NULL. Zum Auffüllen der Statistics-Eigenschaft müssen Sie eine ExpandClause von statsangeben. In der Dokumentation zu einzelnen Klassen finden Sie Informationen dazu, welche Eigenschaften als zugeordnete Entitäten gelten.

Wenn Sie sowohl eine ExpandClause als auch eine SelectClauseangeben, müssen die im ExpandClause aufgeführten Eigenschaften in selectClause wiederholt werden (da nur die in SelectClause aufgeführten Eigenschaften in der Dienstantwort enthalten sind). (Diese Anforderung tritt nicht auf, wenn Sie keinen SelectClause angeben, da dies bedeutet, dass alle Eigenschaften in die Antwort eingeschlossen werden.)

Erweiterungen müssen mithilfe von REST-API-Attributnamen und nicht mit .NET-Eigenschaftsnamen angegeben werden.

Der Standardwert ist kein expand-Ausdruck, d. h. es werden keine zugeordneten Objekte zurückgegeben (und die entsprechenden Eigenschaften sind NULL).

Gilt für: