演练：创建包含代码的基本表单模板

项目
04/04/2023

在 Microsoft InfoPath 中，可以使用 Visual Basic 或 C# 编写业务逻辑，方法是在 InfoPath 设计器中打开表单模板，然后使用某个用户界面命令添加事件处理程序。这将打开 Visual Studio 2012 开发环境供你编写代码。默认情况下，使用 Visual Studio 2012 创建的表单模板项目适用于 Microsoft.Office.InfoPath 命名空间提供的托管代码对象模型。

此演练首先演示了如何在 Visual Studio 2012 开发环境中使用 C# 或 Visual Basic 创建简单的 Hello World 应用程序。最后用代码示例演示了如何使用 User 类的 UserName 属性检索当前用户的名称以及如何使用该值填充“文本框”。

必备组件

为了使用 Visual Studio 2008 开发环境完成此演练，您需要：

Microsoft InfoPath（安装了 Visual Studio 2008）。

Visual Studio Tools for Applications 中的 Hello World

在以下演练中，你将学习如何为 ButtonEvent 类的 Clicked 事件编写一个与“按钮”控件关联的事件处理程序，从而在 Visual Studio 2012 开发环境中编写代码以显示一个简单的警报对话框。

创建一个新项目并指定编程语言

启动 InfoPath 设计器，然后双击“空白(InfoPath 编辑器)”表单模板。
若要指定要使用的编程语言，请依次单击“Office 按钮”、“表单选项”和“类别”列表中的“编程”，然后从“表单模板代码语言”下拉列表中选择“Visual Basic”或“C#”。

注意

“表单模板代码语言”下拉列表中的其他编程语言选项提供与早期版本的 InfoPath 的兼容性。 “C# (InfoPath 2007 兼容)”和“Visual Basic (InfoPath 2007 兼容)”选项将适用于本主题中的过程。但是，若要使用“C# (InfoPath 2003 兼容)”和“Visual Basic (InfoPath 2003 兼容)”选项，请参阅演练：使用 InfoPath 2003 对象模型创建和调试基本表单模板。

现在可以添加“按钮”控件并创建其事件处理程序了。

添加一个按钮控件和事件处理程序

在“控件”组中，单击“按钮”控件以添加表单。
双击“按钮”控件，在功能区的“属性”选项卡上，为“标签”属性键入 Hello，然后单击“自定义代码”。当出现提示时，保存表单并将其命名为 HelloWorld。

这将会打开“Visual Studio Tools for Applications”环境，而且光标出现在“按钮”控件的 Clicked 事件的事件处理程序中。

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

向事件处理程序添加"Hello World"代码并预览表单

在事件处理程序的框架中，键入：

MessageBox.Show("Hello World!");

MessageBox.Show("Hello World!")

表单模板的代码应如下所示：

 using Microsoft.Office.InfoPath;
 using System;
 using System.Windows.Forms;
 using System.Xml;
 using System.Xml.XPath;
 namespace HelloWorld
 {
     public partial class FormCode
     {
         public void InternalStartup()
         {
         ((ButtonEvent)EventManager.ControlEvents["CTRL1_5"]).Clicked += new ClickedEventHandler(CTRL1_5_Clicked);
         }
         public void CTRL1_5_Clicked(object sender, ClickedEventArgs e)
         {
         MessageBox.Show("Hello World!");
         }
     }
 }

 Imports Microsoft.Office.InfoPath
 Imports System
 Imports System.Windows.Forms
 Imports System.Xml
 Imports System.Xml.XPath
 Namespace HelloWorld
     Public Class FormCode
         Private Sub InternalStartup(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Startup
         AddHandler DirectCast(EventManager.ControlEvents("CTRL1_5"), ButtonEvent).Clicked, AddressOf CTRL1_5_Clicked
         End Sub
         Public Sub CTRL1_5_Clicked(ByVal sender As Object, ByVal e As ClickedEventArgs)
         MessageBox.Show("Hello World!")
         End Sub
     End Class
 End Namespace

切换到 InfoPath 设计器窗口。
单击“主页”选项卡上的“预览”按钮。
单击表单上的 Hello 按钮。

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

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

调试表单代码

切换回 Visual Studio 2008 窗口。
单击下面一行左侧的灰色栏：
```
MessageBox.Show("Hello World!");
```
```
MessageBox.Show("Hello World!")
```
将显示一个红色圆圈，并且该代码行突出显示，指示运行时将在表单代码中的此断点处暂停。
在“调试”菜单上，单击“启动调试”（或按 F5）。
在 InfoPath 的“预览”窗口中，单击表单上的 Hello 按钮。
Visual Studio 2008 代码编辑器将获得焦点，断点行将突出显示。
在“调试”菜单上，单击“逐步执行”（或按 Shift+F8）以继续逐步执行代码。
将执行事件处理程序代码，并显示"Hello World!"消息。
单击“确定”返回到 Visual Studio 2012 代码编辑器，然后在“调试”菜单上单击“停止调试”（或按 Ctrl+Alt+Break）。

获取当前用户的名称

在以下示例中，你将学习如何使用 User 类的 UserName 属性来检索当前用户的名称，然后使用 Loading 事件的事件处理程序填充“文本框”控件的值。

填充“文本框”控件可通过使用 XPathNavigator 类的实例将当前用户的名称写入与控件绑定的 XML 节点中来实现。

首先，调用 XmlForm 类的 MainDataSource 属性，以检索代表表单的基础 XML 文档的 DataSource 类的一个实例。然后， DataSource 对象会调用 CreateNavigator 方法，该方法会创建 XPathNavigator 对象并将其置于表单主要数据源的根节点上。

调用 XPathNavigator 类的 SelectSingleNode 方法以选择表单数据源中的 employee 域。最后，调用 SetValue 方法，用 UserName 属性设置该域的值。

有关在托管代码表单模板中使用 System.Xml 的详细信息，请参阅使用 XPathNavigator 和 XPathNodeIterator 类。

添加 Loading 事件处理程序

在 InfoPath 设计器中打开您在前一个演练中创建的 HelloWorld 表单模板。
在“视图”选项卡上，选择“显示域”。
右键单击“myFields” 文件夹，然后单击“添加”。
在“名称”中，键入 employee，然后单击“确定”。
将 employee 域拖到视图中。
在“开发人员”选项卡上，单击“Loading 事件”。

这将为 Loading 事件创建事件处理程序，并将焦点移到代码编辑器中的该事件处理程序。

在代码编辑器中，键入以下代码：

 public void FormEvents_Loading(object sender, LoadingEventArgs e)
 {
     XPathNavigator dataSource;
     dataSource = this.MainDataSource.CreateNavigator();
     dataSource.SelectSingleNode(
         "/my:myFields/my:employee", NamespaceManager).SetValue(this.User.UserName);
 }

 Public Sub FormEvents_Loading(ByVal sender As Object, ByVal e As LoadingEventArgs)
     Dim dataSource As XPathNavigator
     dataSource = Me.MainDataSource.CreateNavigator
     dataSource.SelectSingleNode( _
         "/my:myFields/my:employee", NamespaceManager).SetValue(Me.User.UserName)
 End Sub

切换到 InfoPath 表单设计窗口，然后单击“主页”选项卡上的“预览”按钮以预览表单。

employee 域中应自动填充您的用户名。

后续步骤

有关使用其他控件和事件的事件处理程序的信息，请参阅添加事件处理程序。
有关在表单模板中预览和调试代码的详细信息，请参阅预览和调试包含代码的 InfoPath 表单模板。
有关如何部署托管代码表单模板的信息，请参阅部署包含代码的 InfoPath 表单模板。
有关 InfoPath 对象模型和托管代码表单模板中的常见编程任务的信息，请参阅了解 InfoPath 对象模型和常见开发任务

另请参阅

XmlForm

通过