ODATADetailLevel.SelectClause Propriété

Définition

Espace de noms:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Paquet:

Microsoft.Azure.Batch v16.2.0

Source:

ODATADetailLevel.cs

Obtient ou définit la clause OData select. Utilisé pour récupérer uniquement des propriétés spécifiques au lieu de toutes les propriétés d’objet.

public string SelectClause { get; set; }

member this.SelectClause : string with get, set

Public Property SelectClause As String

Valeur de propriété

String

Remarques

Il s’agit d’une chaîne d’expression $select OData facultative (voir la spécification OData). Si vous fournissez un SelectClause, seules les propriétés répertoriées dans cette clause sont renseignées ; les autres propriétés ont leurs valeurs par défaut (généralement null). Par exemple, si vous effectuez une ListPools(DetailLevel, IEnumerable<BatchClientBehavior>) opération avec selectClause de id,displayName, les propriétés et de DisplayName chacune CloudPool d’elles Id sont remplies, mais d’autres propriétés telles que State ne sont pas récupérées et ont donc leurs valeurs par défaut (généralement null).

Si, quand une entité a été récupérée (via une liste, get ou actualisation), vous avez spécifié un SelectClause qui n’incluait pas la ou les propriétés qui identifient l’objet de manière unique (généralement la propriété Id, mais pour Certificate les propriétés Thumbprint et ThumbprintAlgorithm, toutes les méthodes qui accèdent au service Batch pour récupérer des données ou effectuer des opérations échouent. Cela inclut la plupart des méthodes sur l’objet, notamment Refresh(DetailLevel, IEnumerable<BatchClientBehavior>) et RefreshAsync(DetailLevel, IEnumerable<BatchClientBehavior>, CancellationToken). Vous pouvez toujours accéder aux propriétés (bien que seules les propriétés incluses dans SelectClause soient renseignées).

Les sélections doivent être spécifiées à l’aide de noms d’attributs d’API REST, et non de noms de propriétés .NET.

La valeur par défaut est aucune expression de sélection, ce qui signifie que toutes les propriétés sont retournées.