ODATADetailLevel.SelectClause Eigenschaft

Definition

Namespace:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Paket:

Microsoft.Azure.Batch v16.2.0

Quelle:

ODATADetailLevel.cs

Ruft die OData-Select-Klausel ab oder legt sie fest. Wird verwendet, um nur bestimmte Eigenschaften anstelle aller Objekteigenschaften abzurufen.

public string SelectClause { get; set; }

member this.SelectClause : string with get, set

Public Property SelectClause As String

Eigenschaftswert

String

Hinweise

Dies ist eine optionale OData-$select-Ausdruckszeichenfolge (siehe OData-Spezifikation). Wenn Sie ein SelectClause-Element angeben, werden nur die in dieser Klausel aufgeführten Eigenschaften aufgefüllt. andere Eigenschaften haben ihre Standardwerte (in der Regel NULL). Wenn Sie z. B. einen ListPools(DetailLevel, IEnumerable<BatchClientBehavior>) Vorgang mit einer SelectClause von id,displayNameausführen, werden Id ihre Eigenschaften und DisplayName für jede CloudPool Eigenschaft aufgefüllt, aber andere Eigenschaften wie State werden nicht abgerufen, und daher haben sie ihre Standardwerte (in der Regel NULL).

Wenn Sie beim Abrufen einer Entität (über eine List, Get oder Refresh) eine SelectClause-Eigenschaft angegeben haben, die nicht die Eigenschaft oder Eigenschaften enthält, die das Objekt eindeutig identifizieren (normalerweise die Id-Eigenschaft, aber für Certificate die Eigenschaften Thumbprint und ThumbprintAlgorithm), schlagen alle Methoden fehl, die auf den Batch-Dienst zum Abrufen von Daten oder ausführen von Vorgängen zugreifen. Dies umfasst die meisten Methoden für das -Objekt, einschließlich Refresh(DetailLevel, IEnumerable<BatchClientBehavior>) und RefreshAsync(DetailLevel, IEnumerable<BatchClientBehavior>, CancellationToken). Sie können weiterhin auf Eigenschaften zugreifen (obwohl nur die in SelectClause enthaltenen Eigenschaften aufgefüllt werden).

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

Der Standardwert ist kein Select-Ausdruck, was bedeutet, dass alle Eigenschaften zurückgegeben werden.