columnDefinition 资源类型

命名空间：microsoft.graph

表示 网站、 列表或 contentType 中的列。

默认情况下，不显示 列的hidden columnDefinitions 和字段值。 若要列出隐藏 的 columnDefinitions，请在 hidden 语句 $select 中包含 。 若要列出 listItems 上的隐藏字段值，请在$select语句中按名称添加所需的列。

方法

方法	返回类型	说明
列出网站中的列	columnDefinition 集合	获取网站中 columnDefinition 对象及其属性的列表。
列出列表中的列	columnDefinition 集合	在列表中获取 columnDefinition 对象及其属性 的列表。
列出内容类型中的列	columnDefinition 集合	获取内容类型中的 columnDefinition 对象及其属性的列表。
为网站创建 columnDefinition	columnDefinition	在网站中创建新的 columnDefinition 对象。
为列表创建 columnDefinition	columnDefinition	在列表中创建新的 columnDefinition 对象。
为内容类型创建 columnDefinition	columnDefinition	在内容类型中创建新的 columnDefinition 对象。
获取 columnDefinition	columnDefinition	读取 columnDefinition 对象的属性和关系。
更新 columnDefinition	columnDefinition	更新 columnDefinition 对象的属性。
Delete columnDefinition	无	删除 columnDefinition 对象。

属性

列可以包含各种类型的数据。 以下属性表示列存储的数据类型以及该数据的其他设置。 与类型相关的属性 (布尔值、calculated、choice、currency、dateTime、lookup、number、personOrGroup、text、term、hyperlinkOrPicture、thumbnail 和 contentApprovalStatus) 互斥：列只能指定其中一个列。

属性名称	类型	说明
boolean	booleanColumn	此列存储布尔值。
calculated	calculatedColumn	根据其他列计算此列的数据。
choice	choiceColumn	此列存储所选列表中的数据。
columnGroup	string	对于网站列，此列所属的组的名称。 可以帮助组织相关的列。
contentApprovalStatus	contentApprovalStatusColumn	此列存储内容审批状态。
currency	currencyColumn	此列存储货币值。
dateTime	dateTimeColumn	此列存储日期时间值。
defaultValue	defaultColumnValue	此列的默认值。
说明	string	面向用户的列描述。
displayName	string	面向用户的列名称。
enforceUniqueValues	Boolean	如果 true为 ，则没有两个列表项对此列具有相同的值。
地理位置	geolocationColumn	此列存储地理位置。
hidden	Boolean	指定列是否显示在用户界面中。
hyperlinkOrPicture	hyperlinkOrPictureColumn	此列存储超链接或图片值。
isDeletable	Boolean	指示是否可以删除此列。
isReorderable	Boolean	指示是否可以对列中的值重新排序。 只读。
id	string	列的唯一标识符。
indexed	Boolean	指定列值是否可用于排序和搜索。
isSealed	Boolean	指定是否可以更改列。
lookup	lookupColumn	从网站中的另一个源查找此列的数据。
名称	string	在 listItem 上的 fields 中显示的面向 API 的列名称。 对于面向用户的名称，请参阅 displayName。
number	numberColumn	此列存储数值。
personOrGroup	personOrGroupColumn	此列存储个人或组值。
propagateChanges	Boolean	如果为“true”，则对此列的更改将传播到实现该列的列表。
readOnly	Boolean	指定是否可以修改列值。
required	Boolean	指定列值是否不是可选的。
sourceContentType	contentTypeInfo	从中继承此列的 ContentType。 仅在 contentTypes 列响应中显示。 只读。
术语	termColumn	此列存储分类术语。
text	textColumn	此列存储文本值。
thumbnail	thumbnailColumn	此列存储缩略图值。
type	columnTypes	对于网站栏，为列的类型。 只读。
验证	columnValidation	此列存储列的验证公式和消息。

关系

属性名称	类型	说明
sourceColumn	columnDefinition	内容类型列的源列。

注意： 这些属性对应于 SharePoint SPFieldType 枚举。 请注意，最常见的字段类型在上表中表示。 但是，此 API 仍然缺少一些。 在这些情况下，不会填充列类型 facet，列将仅具有其基本属性。 网站和列表列响应将不包含 isDeletable、 propagateChanges、 isReorderable、 isSealed、 validation、 hyperlinkOrPicture、 term、 sourceContentType、 thumbnail、 type、 contentApprovalStatus 和 sourceColumn 属性。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "boolean": { "@odata.type": "microsoft.graph.booleanColumn" },
  "calculated": { "@odata.type": "microsoft.graph.calculatedColumn" },
  "choice": { "@odata.type": "microsoft.graph.choiceColumn" },
  "columnGroup": "String",
  "contentApprovalStatus": { "@odata.type": "microsoft.graph.contentApprovalStatusColumn" },
  "currency": { "@odata.type": "microsoft.graph.currencyColumn" },
  "dateTime": { "@odata.type": "microsoft.graph.dateTimeColumn" },
  "defaultValue": { "@odata.type": "microsoft.graph.defaultColumnValue" },
  "description": "String",
  "displayName": "String",
  "enforceUniqueValues": "Boolean",
  "geolocation": { "@odata.type": "microsoft.graph.geolocationColumn" },
  "hidden": "Boolean",
  "hyperlinkOrPicture": { "@odata.type": "microsoft.graph.hyperlinkOrPictureColumn" },
  "id": "String (identifier)",
  "indexed": "Boolean",
  "isDeletable" : "Boolean",
  "isReorderable": "Boolean",
  "isSealed": "Boolean",
  "lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
  "name": "staticNameForApi",
  "number": { "@odata.type": "microsoft.graph.numberColumn" },
  "personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
  "readOnly": "Boolean",
  "required": "Boolean",
  "propagateChanges": "Boolean",
  "sourceContentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "term": { "@odata.type": "microsoft.graph.termColumn" },
  "text": { "@odata.type": "microsoft.graph.textColumn" },
  "thumbnail": { "@odata.type": "microsoft.graph.thumbnailColumn" },
  "type": { "@odata.type": "microsoft.graph.columnTypes" },
  "validation": { "@odata.type": "microsoft.graph.columnValidation" }
}