ODATADetailLevel.SelectClause Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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.
S’applique à
Azure SDK for .NET