SubmitToHostAdapterObject 接口

定义

命名空间:

Microsoft.Office.Interop.InfoPath

程序集:

Microsoft.Office.Interop.InfoPath.dll

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

public interface class SubmitToHostAdapterObject : Microsoft::Office::Interop::InfoPath::SubmitToHostAdapter

[System.Runtime.InteropServices.Guid("096CD739-0786-11D1-95FA-0080C78EE3BB")]
public interface SubmitToHostAdapterObject : Microsoft.Office.Interop.InfoPath.SubmitToHostAdapter

type SubmitToHostAdapterObject = interface
    interface SubmitToHostAdapter

Public Interface SubmitToHostAdapterObject
Implements SubmitToHostAdapter

派生

Microsoft.Office.Interop.InfoPath.SubmitToHostAdapterObjectClass

属性

GuidAttribute

实现

SubmitToHostAdapter

示例

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

[InfoPathEventHandler(EventType = InfoPathEventType.OnSubmitRequest]
public void FormEvents_OnSubmitRequest(DocReturnEvent e)
{
   // Get the data adapter defined in the form template from the 
   // DataAdapters collection and cast to the SubmitToHostAdapter
   // type.
   SubmitToHostAdapter submitAdapter = 
      (SubmitToHostAdapter)(DataAdapters["MyHostAdapter"]);

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

   // Execute the submit operation against the adapter.
   submitAdapter.Submit();

<InfoPathEventHandler(EventType := InfoPathEventType.OnSubmitRequest)>
Public Sub FormEvents_OnSubmitRequest(ByVal e As DocReturnEvent)
   ' Get the data connection defined in the form template from the
   ' DataAdapters collection and cast to the SubmitToHostAdapter
   ' type.
   Dim submitAdapter As SubmitToHostAdapter = _
      DirectCast(DataAdapters("MyHostAdapter"), _
      SubmitToHostAdapter)

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

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

注解

此类型是用于 Coclass（托管代码需要此 Coclass 来实现 COM 互操作性）的包装。 使用此类型来访问由此 Coclass 实现的 COM 接口。 有关 COM 接口的信息（包括指向其成员说明的链接），请参阅SubmitToHostAdapter。

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

要创建一个向宿主环境提交数据、并且可以从表单模板中的业务逻辑引用的数据连接，请使用“工具”菜单上的“数据连接”命令。 有关如何创建将在引发事件时 OnSubmitRequest 运行的事件处理程序的信息，请参阅如何：使用 InfoPath 2003 对象模型添加事件处理程序。

属性

Name	获取对象表示 SubmitToHostAdapter 的数据适配器的名称。 (继承自 SubmitToHostAdapter)
QueryAllowed	QueryAllowed 属性可用于 SubmitToHostAdapter 对象，但由于 SubmitToHostAdapter 对象仅可用于提交数据，因此该属性始终返回 false。 (继承自 SubmitToHostAdapter)
SubmitAllowed	SubmitAllowed 属性可用于 SubmitToHostAdapterr 对象，但由于 SubmitToHostAdapter 对象仅可用于提交数据，因此该属性始终返回 true。 (继承自 SubmitToHostAdapter)

方法

Query()	Query 方法可用于 SubmitToHostAdapter 对象，但由于 SubmitToHostAdapter 对象仅可用于提交数据，因此该方法在该对象上调用该方法时将始终生成运行时错误。 (继承自 SubmitToHostAdapter)
Submit()	对 对象执行提交操作 SubmitToHostAdapter 。 (继承自 SubmitToHostAdapter)