卡片状态项（cardstateitem）表/实体参考（Microsoft Dataverse）

2025-10-31

Messages

下表列出了“卡片状态项”（cardstateitem）表的消息。消息表示可以在表上执行的作。它们也可能是事件。

名称是事件？	Web API 操作	SDK for .NET
`Associate` 事件：True	关联记录	关联记录
`Create` 事件：True	`POST` /cardtateitems 请参阅创建	创建记录
`CreateMultiple` 事件：True	CreateMultiple	CreateMultipleRequest
`Delete` 事件：True	`DELETE` /cardtateitems（cardtateitemid）请参阅删除	删除记录
`DeleteMultiple` 事件：True	DeleteMultiple	了解如何将消息与 SDK for .NET 配合使用
`Disassociate` 事件：True	取消关联记录	取消关联记录
`Retrieve` 事件：True	`GET` /cardtateitems（cardtateitemid）请参阅检索	检索记录
`RetrieveEntityChanges` 事件：True		RetrieveEntityChangesRequest
`RetrieveMultiple` 事件：True	`GET` /cardtateitems 查看查询数据	查询数据
`Update` 事件：True	`PATCH` /cardtateitems（cardtateitemid）查看更新	更新记录
`UpdateMultiple` 事件：True	UpdateMultiple	UpdateMultipleRequest
`Upsert` 事件：True	`PATCH` /cardtateitems（cardtateitemid）请参阅更新插入表行	UpsertRequest
`UpsertMultiple` 事件：True	UpsertMultiple	UpsertMultipleRequest

事件

下表列出了“卡片状态项”（cardstateitem）表的事件。事件是可供订阅的消息。除非您添加了该事件，否则不应调用该消息，仅可订阅它。

Name	Web API 操作	SDK for .NET
`BulkRetain`	BulkRetain	了解如何将消息与 SDK for .NET 配合使用
`PurgeRetainedContent`	PurgeRetainedContent	了解如何将消息与 SDK for .NET 配合使用
`Retain`	Retain	了解如何将消息与 SDK for .NET 配合使用
`RollbackRetain`	RollbackRetain	了解如何将消息与 SDK for .NET 配合使用
`ValidateRetentionConfig`	ValidateRetentionConfig	了解如何将消息与 SDK for .NET 配合使用

属性

下表列出了卡片状态项（cardstateitem）表的选定属性。

资产	价值
显示名称	卡片状态项
显示集合名称	卡片状态项
架构名称	`cardstateitem`
集合架构名称	`cardstateitems`
实体集名称	`cardstateitems`
逻辑名称	`cardstateitem`
逻辑集合名称	`cardstateitems`
PrimaryId属性	`cardstateitemid`
PrimaryName属性	`name`
表类型	`Elastic`
所有权类型	`OrganizationOwned`

可写列/属性

这些列/属性为 IsValidForCreate 或 IsValidForUpdate （通常两者）返回 true。按 SchemaName 列出。

Cache
CardId
CardInstanceId
cardstateitemId
数据
导入序列号
name
覆盖创建时间
分区 ID
Scope
TTL秒数

缓存

资产	价值
Description
显示名称	Cache
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`cache`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1048576

CardId

资产	价值
Description
显示名称	卡 ID
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`cardid`
RequiredLevel	系统必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

CardInstanceId

资产	价值
Description
显示名称	卡实例 ID
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`cardinstanceid`
RequiredLevel	系统必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

cardstateitemId

资产	价值
Description	实体实例的唯一标识符
显示名称	卡片状态项 ID
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`cardstateitemid`
RequiredLevel	系统必填
类型	Uniqueidentifier

Data

资产	价值
Description
显示名称	数据
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`data`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1048576

ImportSequenceNumber

资产	价值
Description	创建此记录的导入的序列号。
显示名称	导入序列号
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`importsequencenumber`
RequiredLevel	None
类型	整数
最大值	2147483647
最小值	-2147483648

姓名

资产	价值
Description	自定义实体的名称。
显示名称	名称
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`name`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

OverriddenCreatedOn

资产	价值
Description	迁移记录的日期和时间。
显示名称	记录创建时间
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`overriddencreatedon`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	DateOnly
ImeMode	未激活
源类型掩码	0

分区 ID

资产	价值
Description	逻辑分区 ID。逻辑分区由一组具有相同分区 ID 的记录组成。
显示名称	分区 ID
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`partitionid`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

Scope

资产	价值
Description
显示名称	Scope
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`scope`
RequiredLevel	系统必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	60

TTL秒数

资产	价值
Description	生存时间以秒为单位。
显示名称	活着的时间
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`ttlinseconds`
RequiredLevel	None
类型	整数
最大值	2147483647
最小值	1

只读列/属性

这些列/属性为 IsValidForCreate 和 IsValidForUpdate 返回 false。按 SchemaName 列出。

CreatedBy
创建时间
创建时BehalfBy
ModifiedBy
修改时间
ModifiedOnBehalfBy
版本编号

创建者

资产	价值
Description	创建记录的用户的唯一标识符。
显示名称	创建者
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`createdby`
RequiredLevel	None
类型	查找
Targets	systemuser

CreatedOn

资产	价值
Description	创建记录的日期和时间。
显示名称	创建时间
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`createdon`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

创建时BehalfBy

资产	价值
Description	创建记录的委托用户的唯一标识符。
显示名称	创建者（委托）
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`createdonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

ModifiedBy

资产	价值
Description	修改记录的用户的唯一标识符。
显示名称	修改者
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`modifiedby`
RequiredLevel	None
类型	查找
Targets	systemuser

修改时间

资产	价值
Description	修改记录的日期和时间。
显示名称	修改时间
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`modifiedon`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

ModifiedOnBehalfBy

资产	价值
Description	修改记录的委托用户的唯一标识符。
显示名称	修改者（委托）
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`modifiedonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

版本号

资产	价值
Description	版本号
显示名称	版本号
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`versionnumber`
RequiredLevel	None
类型	BigInt
最大值	9223372036854775807
最小值	-9223372036854775808

多对一关系

这些关系是多对一的。按 SchemaName 列出。

lk_cardstateitem_createdby
lk_cardstateitem_createdonbehalfby
lk_cardstateitem_modifiedby
lk_cardstateitem_modifiedonbehalfby

lk_cardstateitem_createdby

单To-Many 关系： systemuser lk_cardstateitem_createdby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`createdby`
ReferencingEntityNavigationPropertyName	`createdby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_cardstateitem_createdonbehalfby

一To-Many 关系： systemuser lk_cardstateitem_createdonbehalfby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`createdonbehalfby`
ReferencingEntityNavigationPropertyName	`createdonbehalfby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_cardstateitem_modifiedby

单To-Many 关系： systemuser lk_cardstateitem_modifiedby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`modifiedby`
ReferencingEntityNavigationPropertyName	`modifiedby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_cardstateitem_modifiedonbehalfby

一To-Many 关系： systemuser lk_cardstateitem_modifiedonbehalfby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`modifiedonbehalfby`
ReferencingEntityNavigationPropertyName	`modifiedonbehalfby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

另请参阅

Dataverse 表/实体引用
 Dataverse Web API 参考
 cardstateitem

反馈

此页面是否有帮助？