你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
ODATADetailLevel.SelectClause 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置 OData select 子句。 用于仅检索特定属性,而不是检索所有对象属性。
public string SelectClause { get; set; }
member this.SelectClause : string with get, set
Public Property SelectClause As String
属性值
注解
这是可选的 OData $select表达式字符串 , (请参阅 OData 规范) 。 如果提供 SelectClause,则 仅 填充该子句中列出的属性;其他属性的默认值 (通常为 null) 。 例如,如果使用 SelectClause id,displayName
执行ListPools(DetailLevel, IEnumerable<BatchClientBehavior>)操作,则每个CloudPool属性都将填充其 Id 和 DisplayName 属性,但不会检索其他属性(例如State),因此其默认值通常 (null) 。
如果在通过 List、Get 或 Refresh) (检索实体时,指定了一个 SelectClause,该属性不包含唯一标识对象的一个或多个属性 (通常为 Id 属性,但对于 Certificate Thumbprint 和 ThumbprintAlgorithm 属性,则访问 Batch 服务以检索数据或执行操作的任何方法都将失败。 这包括 对象上的大多数方法,包括 Refresh(DetailLevel, IEnumerable<BatchClientBehavior>) 和 RefreshAsync(DetailLevel, IEnumerable<BatchClientBehavior>, CancellationToken)。 你仍然可以访问属性 (但只有 SelectClause 中包含的属性将填充) 。
必须使用 REST API 属性名称(而不是 .NET 属性名称)指定所选内容。
默认值为无 select 表达式,这意味着将返回所有属性。