SubmitToHostConnection 类

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

代表用于向宿主环境提交数据的连接。

public ref class SubmitToHostConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class SubmitToHostConnection : Microsoft.Office.InfoPath.DataConnection

type SubmitToHostConnection = class
    inherit DataConnection

Public MustInherit Class SubmitToHostConnection
Inherits DataConnection

继承

Object

DataConnection

SubmitToHostConnection

示例

下面的示例显示了一种代码编写模式，它将在提交表单之前在表单模板的业务逻辑中执行自定义操作。

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   // Get the data connection defined in the form template from the 
   // DataConnections collection and cast to the SubmitToHostConnection
   // type.
   SubmitToHostConnection submitConnection = 
      (SubmitToHostConnection)(DataConnections["MyHostConnection"]);

   // Write code here to do custom actions that are not 
   // supported by rules or other declarative settings.  

   // Execute the submit operation against the connection.
   submitConnection.Execute();

}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArg)
   ' Get the data connection defined in the form template from the
   ' DataConnections collection and cast to the SubmitToHostConnection
   ' type.
   Dim submitConnection As SubmitToHostConnection = _
      DirectCast(DataConnections("MyHostConnection"), _
      SubmitToHostConnection)

   ' Write code here to do custom actions that are not 
   ' supported by rules or other declarative settings.

   ' Execute the submit operation against the connection.
   submitConnection.Execute()
End Sub

注解

该类型的连接在表单模板中使用，表单模板由将 InfoPath 表单编辑环境当作控件来承载的应用程序打开。 有关托管 InfoPath 作为控件的信息，包括有关如何创建方法以处理在宿主应用程序代码中提交表单的事件的信息，请参阅标题为在自定义 Windows 窗体应用程序中托管 InfoPath 表单编辑环境的文章

若要创建一个向宿主环境提交数据、并且可以从表单模板中的业务逻辑引用的数据连接，请使用功能区的“数据”选项卡上的“数据连接”命令。 有关如何创建将在引发事件时 Submit 运行的事件处理程序的信息，请参阅如何：添加事件处理程序。

构造函数

SubmitToHostConnection()

代表用于向宿主环境提交数据的连接。

属性

Name	获取数据连接的名称。 (继承自 DataConnection)

方法

Execute()

根据从中调用数据连接的 ConnectionTypeConnection 类，使用以声明形式为已提交数据、查询参数或要检索的数据定义的值，在数据连接上执行提交或查询操作。 (继承自 DataConnection)