你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ODATADetailLevel 类

定义

命名空间:

Microsoft.Azure.Batch

程序集:

Microsoft.Azure.Batch.dll

包:

Microsoft.Azure.Batch v16.2.0

Source:

ODATADetailLevel.cs

使用 OData 查询子句控制列出或检索资源时从Azure Batch服务请求的详细信息量。

public class ODATADetailLevel : Microsoft.Azure.Batch.DetailLevel

type ODATADetailLevel = class
    inherit DetailLevel

Public Class ODATADetailLevel
Inherits DetailLevel

继承

Object

DetailLevel

ODATADetailLevel

示例

此示例演示如何指定一个 ODataDetailLevel，该 ODataDetailLevel 仅列出活动的 CloudPools，并且仅IdDisplayNameStatistics检索每个池 (例如，在报表用户界面) 中显示。

var detailLevel = new ODATADetailLevel(
    filterClause: "state eq 'active'",
    selectClause: "id,displayName,stats",
    expandClause: "stats"
);

var pools = batchClient.PoolOperations.ListPools(detailLevel);

注解

Azure Batch 支持 OData 查询，通过控制在列表操作 () FilterClause 返回的资源，以及每个资源的哪些属性在 List、Get 或 Refresh 操作 (和ExpandClause) SelectClause中返回，使客户端能够更精细地控制查询性能。

默认情况下，如果未将 传递给 DetailLevel List、Get 或 Refresh 操作，Batch 客户端不会指定筛选器 () 返回所有记录，不指定 select 子句 () 返回所有简单属性，并且不) 返回任何 expand 子句 (关联的实体。 因此，默认情况下，关联的实体属性为 null，而不是像其他属性一样填充。 请参阅各个类文档，了解哪些属性被视为关联实体，需要展开才能填充。

由于 OData 查询直接传递到 REST API，因此子句字符串必须使用 REST API 中的 JSON 属性名称，这些名称并不总是与 .NET 属性名称相同。 例如，.NET CloudPool.VirtualMachineSize 属性对应于 REST API 中的 vmSize 属性;因此，若要按 VM 大小筛选池列表操作，需要在筛选器字符串中编写 vmSize 而不是 VirtualMachineSize。 请参阅 REST API 文档，了解与 .NET 属性对应的 JSON 属性名称。

有关使用 OData 高效查询Azure Batch服务的其他信息，请参阅 MSDN 上的高效列表查询。

构造函数

ODATADetailLevel()	使用空子句初始化 类的新实例 ODATADetailLevel 。
ODATADetailLevel(String, String, String)	使用指定的 子句初始化 类的新实例 ODATADetailLevel 。

属性

ExpandClause	获取或设置 OData expand 子句。 用于检索main实体的关联实体。
FilterClause	获取或设置 OData 筛选器子句。 用于将列表操作限制为符合指定条件的项。
SelectClause	获取或设置 OData select 子句。 用于仅检索特定属性，而不是检索所有对象属性。