通过

property 元素

属性节点定义组件需要Microsoft Dataverse 的特定可配置数据片段。

适用于

模型驱动和画布应用

属性

Name Description 类型 必选 适用于
default-value 提供给组件的默认配置值。 在模型驱动应用中，仅允许对输入使用此属性，因为绑定参数需要具有关联的列。 字符串 可选 模型驱动应用
description-key 在自定义屏幕中用作描述属性说明的本地化字符串。 字符串 可选 模型驱动和画布应用
display-name-key 在自定义屏幕中用作描述属性名称的本地化字符串。 字符串 是的 模型驱动应用
姓名 属性的名称 字符串 是的 模型驱动和画布应用
of-type-group 清单中定义的类型组的名称 字符串 可选 模型驱动应用
of-type 定义属性的数据类型 请参阅 “使用类型” 可选 模型驱动和画布应用
pfx-default-value 提供给组件的默认 PFX 表达式值。 请参阅 使用 pfx-default-value 可选 画布应用
required 属性是否是必需的 布尔 可选 模型驱动应用
使用情况 usage 属性标识属性是否表示组件可以更改（绑定）、只读（输入）或输出值的列 绑定、输入或输出 是的 模型驱动应用

注解

本部分包含有关使用 Property 元素属性的指南。

使用类型

of-type属性值必须是下列值之一：

价值 Description 适用于
货币 此列中可以有介于 -922,337,203,685,477 和 922,337,203,685,477 之间的货币值。 模型驱动和画布应用
DateAndTime.DateAndTime 显示日期和时间。 模型驱动和画布应用
DateAndTime.DateOnly 仅显示日期。 模型驱动和画布应用
Decimal 此列中可以有 10 位小数精度的介于 -100,000,000,000 与 100,000,000,000 之间的值。 模型驱动和画布应用
Enum 枚举数据类型。 模型驱动和画布应用
FP 此列中最多可以使用 5 个小数点的精度值介于 -100,000,000,000 和 -100,000,000,000 之间。 模型驱动和画布应用
Lookup.Simple 允许对特定表的单个引用。 所有自定义查找都是此类型。 模型驱动应用
Multiple 此列中最多可以包含 1,048,576 个文本字符。 模型驱动和画布应用
MultiSelectOptionSet 可以通过添加选项列来自定义窗体（主窗体、快速创建和快速视图）和电子邮件模板。 添加选项列时，可以指定可供用户选择的多个值。 当用户填写表单时，他们可以选择一个、多个值或下拉列表中显示的所有值。 模型驱动和画布应用
物体 对象数据类型。 只能与输出属性一起使用。 模型驱动和画布应用
OptionSet 此列提供一组选项。 每个选项都有一个数字值和标签。 添加到窗体时，此列将显示一个控件，供用户仅选择一个选项。 模型驱动和画布应用
SingleLine.Email 这会以对电子邮件有效的格式存储字符串时间。 现成的统一接口控件会自动使它们可单击链接。 模型驱动和画布应用
SingleLine.Phone 这会以对 Phone 有效的格式存储字符串时间。 现成的统一接口控件会自动使它们可单击链接。 模型驱动和画布应用
SingleLine.Text 此选项仅显示文本。 模型驱动和画布应用
SingleLine.TextArea 此格式选项可用于显示多行文本。 但限制为 4000 个字符，如果预期大量文本，“多行文本”列是更好的选择。 模型驱动和画布应用
SingleLine.Ticker 这会以 Ticker 有效的格式存储字符串时间。 现成的统一接口控件会自动使它们可单击链接。 模型驱动和画布应用
SingleLine.URL 应提供超链接的文本以打开指定的页面。 现用的统一接口控件自动将“https://”追加到不以有效协议开头的输入值。 此列中仅需要 HTTP、HTTPS、FTPS、OneNote 和 TEL 协议。 模型驱动和画布应用
TwoOptions 此列提供两个选项。 每个选项的数字值为 0 或 1，对应于 false 或 true 值。 每个选项还有一个标签，以便将 true 或 false 值表示为“是”和“否”、“热”和“冷”、“开”和“关”或要显示的任意一对标签。 模型驱动和画布应用
Whole.None 此选项仅显示数字。 模型驱动和画布应用

警告

manifest.xml如果文件至少包含一个数据集，则类型属性Lookup.Simple也应包装到数据集元素中。

不支持的值元素

目前不支持以下 of-type 属性值：

价值 Description
Lookup.Customer 允许对客户或联系人记录的单个引用。 这些查找适用于商机、案例、报价、订单和发票表。 这些表还具有单独的帐户和联系人查找，如果客户始终是一种类型，则可以使用这些查找。 或者可以包含这两者，而不是使用客户查找。
Lookup.Owner 允许对团队或用户记录进行单个引用。 所有团队或用户拥有的表都有其中一个。
Lookup.PartyList 允许对多个表进行多个引用。 在“电子邮件”表 的“收件人 ”和“ 抄送 ”列中可以找到这些查找。 它们也用于“电话”和“约会”表。
Lookup.Regarding 允许对多个表进行单个引用。 有关活动中使用的列，可以找到这些查找。
状态描述 一个系统列，其中包含提供有关“状态”列的更多详细信息的选项。 每个选项都与其中一个可用状态选项相关联。 可以添加和编辑选项。
状态 一个系统列，其选项通常对应于活动状态和非活动状态。 某些系统列具有更多选项，但所有自定义列仅具有“活动”和“非活动”状态选项。
Whole.Duration 此格式选项可用于显示持续时间选项列表。 但数据库中存储的数据始终是分钟数。 该列看起来像一个下拉列表，并提供建议的选项，例如 1 分钟、15 分钟、30 分钟，最多三天。 用户可以选择这些选项。 但是，人们也可以只键入几分钟，并解析为该时间段。
Whole.Language 此选项显示为组织预配的语言列表。 这些值显示为语言名称的下拉列表，但数据使用 LCID 代码存储为数字。 四位数或五位数区域设置 ID 的语言代码。 可在区域设置 ID (LCID) 图表中找到有效区域设置 ID 值。
Whole.TimeZone 此选项显示时区的选择列表，例如（GMT-12：00）国际日期线西部和（GMT-08：00）太平洋时间（美国和加拿大）。 其中每个区域都存储为数字。 例如，对于时区（GMT-08：00）太平洋时间（美国和加拿大），TimeZoneCode 为 4。

注释

目前不支持文件列。 详细信息： 文件列

使用 pfx-default-value

使用 pfx-default-value 属性值通过 Power Fx 表达式而不是静态默认值来计算事件和属性。 可以使用以下方法：

  • 响应式调整控件的大小
  • 访问连接器
  • 提供示例数据
  • 引用主题属性
  • 自定义事件

注释

  • 可以使用任何 Power Fx 表达式，但必须在导入控件时确保表达式有效。
  • 如果使用内部引号或其他特殊字符，请将值包装在单引号中，例如： pfx-default-value='"Test"'
  • 可以引用其他控件（包括屏幕）及其属性。 将这些引用写为： %ControlName.ID%.ControlProperty. 例如：pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • 编写枚举，例如 DisplayType 和 ScreenTransition as： %EnumName.RESERVED%.EnumValue。 例如：pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • 如果 pfx-default-value 包含，则优先于 default-value。

父元素

元素 Description
控制 定义组件的命名空间、版本和显示信息。

Example

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

Power Apps 组件框架清单架构参考
Power Apps 组件框架 API 参考
Power Apps 组件框架概述

  • Last updated on