Form OnLoad 事件

此事件在加载窗体时发生,具体来说:

  • 初始页面加载时
  • 首次保存新记录后(已创建)

使用 formContext.ui。addOnLoad 和 formContext.ui。removeOnLoad 方法用于管理此事件的事件处理程序。

注释

当窗体的事件发生时,窗体 OnLoad 中的控件可能尚未准备就绪。 OnLoad使用控件的事件等待控件准备就绪。 详细信息: 使用 UI 向事件添加或删除事件处理程序函数

异步 OnLoad 事件处理程序支持

OnLoad事件处理程序能够在加载允许OnLoad事件异步(“async”)的表单之前等待事件处理程序返回的承诺来解决。 当事件处理程序返回承诺时,该 OnLoad 事件将成为异步事件。

解析事件处理程序返回的每个承诺时,窗体将加载。 对于返回的任何承诺,每个承诺都有 10 秒的限制。 之后,平台将承诺超时。此超时按承诺应用。 例如,如果返回了 5 个承诺,则总等待时间为 50 秒。 假设承诺被拒绝或超时。在这种情况下,窗体加载作的行为类似于当前脚本错误。

OnLoad 事件将等待每个处理程序返回的一个承诺。 如果需要多个承诺,建议在方法中 Promise.all() 包装所有承诺并返回单个生成的承诺。 对于返回承诺的多个处理程序,建议创建一个处理程序来调用所有事件,并返回包装所有所需承诺的单个承诺。 这是为了最大程度地减少超时导致的等待时间。

使用应用设置启用 Async OnLoad

若要使用异步 onLoad 处理程序,需要通过应用设置启用它。 应用设置是一个平台组件,允许你为应用打开或关闭受支持的功能。 若要为特定应用启用异步 Onload 事件处理程序,请执行以下作:

  1. 转到 https://make.powerapps.com

  2. 请确保选择正确的环境。

  3. 从左侧导航窗格中选择 “应用 ”。

  4. 选择应用,然后选择 ... (省略号)。 选择 编辑

  5. 在命令栏中选择设置

  6. 当对话框打开时,选择 “功能”。

  7. 打开 Async onload 处理程序

  8. 选择“保存”

    Async OnLoad 应用设置

异步 OnLoad 超时

使用异步处理程序时,窗体加载将等待承诺完成,但最多 10 秒。 此限制可确保窗体在合理的时间内加载。

事件(客户端 API 参考)
模型驱动应用内窗体和网格中的事件