从嵌入的区域应用内在主机模型驱动窗体上执行预定义的操作

嵌入的区域应用提供在主机模型驱动窗体上执行预定义操作的功能。 这些操作让开发者可以导航、刷新、保存主机模型驱动窗体。 使用这些操作，嵌入的区域应用可以充当更重要的模型驱动窗体和模型驱动应用的组成部分。

ModelDrivenFormIntegration 对象现在包括以下新方法以允许开发者在主机模型驱动窗体上执行操作。

NavigateToMainForm(entityName, mainFormName, recordId)

在主机模型驱动窗体上导航到主窗体并显示指定行。

• entityName - 指定主窗体的父表的必需字符串参数。
• formName - 指定要导航到的主窗体名称的必需字符串参数。
• recordId - 必需的字符串参数，指定要在主窗体中显示的行的 ID。

调用 NavigateToMainForm 方法可能显示以下错误消息。

错误消息	疑难解答指南
未找到表：[EntityName]	请检查 entityName 参数的值并确保它是有效的表名称，以及用户有权访问它。
找不到窗体：[FormName]	请检查 mainFormName 参数的值并确保它是有效的主窗体名称，以及用户有权访问它。
加载行时出现问题。	请检查 recordId 参数的值并确保它是有效的行 ID，以及用户有权访问它。

NavigateToView(entityName, viewName)

在主机模型驱动窗体中导航到视图。

• entityName - 指定视图的父表的必需字符串参数。
• viewName - 指定要导航到的主窗体名称的必需字符串参数。

调用 NavigateToView 方法可能显示以下错误消息。

错误消息	疑难解答指南
未找到表：[EntityName]	请检查 entityName 参数的值并确保它是有效的表名称，以及用户有权访问它。
找不到视图：[ViewName]	请检查 viewName 参数的值并确保它是有效的视图名称，以及用户有权访问它。

OpenQuickCreateForm(entityName)

打开表的默认快速创建窗体。

• entityName - 指定快速创建窗体的父表的必需字符串参数。

调用 OpenQuickCreateForm 方法可能显示以下错误消息。

错误消息	疑难解答指南
未找到表：[EntityName]	请检查 entityName 参数的值并确保它是有效的表名称，以及用户有权访问它。

RefreshForm(showPrompt)

刷新主机模型驱动窗体上的数据。

• showPrompt - 必需的布尔参数，指示是否应在保存主机模型驱动窗体上的任何未保存数据前向用户显示确认提示。 值应为“true”或“false”。

调用 RefreshForm 方法可能显示以下错误消息。

错误消息	疑难解答指南
请使用“true”或“false”作为参数值。	请检查 showPrompt 参数的值并确保它为“true”或“false”。

SaveForm()

保存主机模型驱动窗体上的数据。

备注

如果您在功能变为可用之前创建的嵌入区域应用中未看到用于执行预定义操作的方法的 IntelliSense；保存、关闭并重新打开应用。

另请参阅

在模型驱动的窗体上嵌入区域应用
在模型驱动窗体上添加嵌入式区域应用
编辑在模型驱动窗体上嵌入的区域应用
自定义在模型驱动窗体上嵌入的区域应用的屏幕尺寸和方向
ModelDrivenFormIntegration 控件的属性和操作
共享嵌入式区域应用
嵌入式区域应用使用指南
迁移使用最新的公共预览版本创建的模型驱动窗体上的嵌入式区域应用

备注

您能告诉我们您的文档语言首选项吗？ 进行简短调查。（请注意，此调查是英文版调查）

此调查大约需要七分钟。 不会收集个人数据（隐私声明）。