演练：使用 InfoPath 对象模型创建和调试基本表单模板

2023-04-04

本主题演练如何创建与 Microsoft.Office.Interop.InfoPath.SemiTrust 命名空间提供的 InfoPath 2003 兼容对象模型的基本 InfoPath 托管代码表单模板。

Hello World

在以下示例中，你将了解如何使用 InfoPath 2003 兼容对象模型的 Alert 方法显示简单的警报对话框。

新建使用 InfoPath 2003 兼容对象模型的 InfoPath 表单模板

按照使用 InfoPath 2003 对象模型创建表单模板中所述，创建一个适用于 InfoPath 2003 兼容对象模型的新表单模板。
将该表单模板项目命名为 HelloWorld 并保存它。

项目系统会创建代码文件和项目文件，然后在 InfoPath 设计模式下打开一个空白的表单模板。现在可以添加事件处理程序了。

添加包含 OnClick 事件处理程序的按钮

在“主页”选项卡的“控件”部分，单击“按钮”控件以将其插入视图中。
右键单击该控件，然后单击“按钮属性”。
将 “标签” 更改为“警报”。
将 ID 更改为 AlertID。
单击“编辑表单代码”。

将创建 OnClick 事件的事件处理程序框架，并将焦点移动到 Visual Studio 2012 中的代码编辑器。有关使用事件处理程序的详细信息，请参阅使用 InfoPath 2003 对象模型添加事件处理程序。

现在可以向该按钮的事件处理程序中添加表单代码了。

向事件处理程序中添加表单代码

在 OnClick 事件处理程序中，键入下面的代码：
```
 thisXDocument.UI.Alert("Hello World!");
```
```
 thisXDocument.UI.Alert("Hello World!")
```
请注意，在代码行中每键入一个句点之后，都会显示一个 Microsoft IntelliSense 下拉列表。整个事件处理程序看上去应当如下所示：
```
 [InfoPathEventHandler(MatchPath="AlertID", EventType=InfoPathEventType.OnClick)]
 public void AlertID_OnClick(DocActionEvent e)
 {
     thisXDocument.UI.Alert("Hello World!");
 }
```
```
 <InfoPathEventHandler(MatchPath:="AlertID", EventType:=InfoPathEventType.OnClick)>
 Public Sub AlertID_OnClick(ByVal e As DocActionEvent)
     thisXDocument.UI.Alert("Hello World!")
 End Sub
```
注意

除了 Alert 方法，还可以使用 System.Windows.Forms 命名空间的 MessageBox.Show 方法来显示消息框。为此，必须添加对 System.Windows.Forms 程序集的引用，在代码文件的开头添加 using System.Windows.Forms; 或 Imports System.Windows.Forms 指令，然后键入如下代码行： MessageBox.Show("Hello World!); or MessageBox.Show("Hello World!)
切换到 InfoPath 设计模式窗口，然后单击“主页”选项卡上的“预览”按钮。
在“预览”窗口中，单击“Alert”按钮。

将显示一个消息框，其中包含“Hello World!”文本。

下一个过程演示如何向表单代码中添加调试断点。

调试表单代码

在代码编辑器中，单击该行左侧的灰条：
```
 thisXDocument.UI.Alert("Hello World!");
```
```
 thisXDocument.UI.Alert("Hello World!")
```
将显示一个红色圆圈，并且该代码行突出显示，指示运行时将在表单代码中的此断点处暂停。
在“调试”菜单上，单击“启动调试”（或按 F5）。
在 InfoPath 的“预览”窗口中，单击“Alert”按钮。

代码编辑器将获得焦点，并且断点行突出显示。
在“调试”菜单上，单击“单步执行(跳过过程)”（或按 Shift+F8）继续单步执行代码。

将执行 Alert 方法代码，并在 InfoPath 预览窗口中显示“Hello World！”警报。

获取当前用户的名称

通过使用 .NET Framework 类，可以访问不便通过脚本使用的功能。在此示例中，您将了解如何使用 .NET Framework 类来检索当前用户的名称。

添加 OnLoad 事件处理程序

打开前面创建的 InfoPath HelloWorld 项目。
在“视图”选项卡上，单击“显示域”。
右键单击“myFields”节点，然后单击“添加”。
在“名称”中，键入“employee”，然后单击“确定”。
将“employee”节点拖到视图中。
在“开发工具”选项卡上，单击“OnLoad 事件”。

这将为 OnLoad 事件创建事件处理程序，并将焦点移动到代码编辑器。每次加载表单时，都将调用该事件处理程序中的代码。下一个过程演示如何将检索用户名的表单代码添加到事件处理程序中。

添加表单代码

在 OnLoad 事件处理程序中，键入下面的代码：

 // Store an XML DOM node as a local variable.
 IXMLDOMNode nodeEmployee = thisXDocument.DOM.selectSingleNode("my:myFields/my:employee");
 if(nodeEmployee != null)
 {
     if(nodeEmployee.text == "")
     {
     // If the employee name is blank when the form is loaded, 
     // populate the employee node with the current user name.
     nodeEmployee.text = System.Environment.UserName;
     }
 }

 // Store an XML DOM node as a local variable.
 Dim nodeEmployee As IXMLDOMNode
 nodeEmployee = thisXDocument.DOM.selectSingleNode("my:myFields/my:employee");
 If Not(nodeEmployee Is Nothing) Then
     If(nodeEmployee.text = "") Then
     // If the employee name is blank when the form is loaded, 
     // populate the employee node with the current user name.
     nodeEmployee.text = System.Environment.UserName
     End If
 End If

编译和预览该表单。

employee 文本框现在应当填写了您的用户名。

有关如何部署托管代码表单模板的信息，请参阅使用代码部署 InfoPath 表单模板。有关使用 InfoPath 2003 兼容对象模型的托管代码表单模板中的 InfoPath 对象模型和常见编程任务的信息，请参阅了解 InfoPath 2003 对象模型。

通过