FieldValueSet 资源FieldValueSet resource

命名空间:microsoft.graphNamespace: microsoft.graph

表示 listItem 资源中的列值。Represents the column values in a listItem resource.

JSON 表示形式JSON representation

下面是 fieldValueSet 资源的 JSON 表示形式。Here is a JSON representation of a fieldValueSet resource.

{
    "Author": "Brad Cleaver",
    "AuthorLookupId": "13",
    "Name": "Kangaroos and Wallabies: A Deep Dive",
    "Color": "Red",
    "Quantity": 350,
}

属性Properties

listItem 中的每个用户可见字段作为 fieldValueSet 中的名称/值对返回。Each user-visible field in the listItem is returned as a name-value pair in the fieldValueSet. 上面是针对包含作者名称颜色数量这四列列表的一个示例。The example above is for a list that contains four columns, Author, Name, Color, and Quantity.

默认情况下不返回查找字段(如上述 Author)。Lookup fields (like Author above) are not returned by default. 相反,服务器会返回一个引用查找中锁定的 listItem 的“LookupId”字段(如上述 AuthorLookupId)。Instead, the server returns a 'LookupId' field (like AuthorLookupId above) referencing the listItem targeted in the lookup. “LookupId”字段的名称是原始字段名称,后跟 LookupIdThe name of the 'LookupId' field is the original field name followed by LookupId.

单个查询中可能请求最多 12 个查找字段。Up to 12 lookup fields may be requested in a single query. 如果请求包含带所需字段的 select 语句,服务器将返回查找值。The server will return lookup values if your request includes a select statement with the fields you need. 示例:Example:

GET https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}/items?expand=fields(select=Author,BookTitle,PageCount)

你可以在单个查询中请求最多 12 个查找字段以及任意数量的常规字段。You may request up to 12 lookup fields in a single query, plus any number of regular fields.