submitToHostAdapter Element

  • Article

Defines a data connection for submitting data to a hosting environment.

Type

  xsd:complexType

Parent Elements

dataAdapters

Child Elements

None.

Attributes

Name Description
name (Required attribute) Specifies the name of the submitToHostAdapter element.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.
queryAllowed (Optional attribute) Specifies whether data can be retrieved from the data source through the Query method of the data adapter object.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.
submitAllowed (Optional attribute) Specifies whether data can be submitted to the data source through the Submit method of the data adapter object.

Definition

  <xsd:element name="submitToHostAdapter">
   <xsd:complexType>
      <xsd:attribute name="name" type="xsf:xdTitle" use="required" />
      <xsd:attribute name="queryAllowed" type="xsf:xdYesNo" use="optional" />
      <xsd:attribute name="submitAllowed" type="xsf:xdYesNo" use="optional" />
   </xsd:complexType>
</xsd:element>

Remarks

** Important **  The submitToHostAdapter element was added to the XSF schema to implement Microsoft Office InfoPath 2007 functionality and is not valid in the manifest.xsf file of a form template file that is meant to be compatible with InfoPath 2003.

This type of data connection allows form data to be submitted to a host enviroment, such as a custom Windows application or a Web application. When the InfoPath editor is hosted in a custom application, this type of data connection can be used to send validated, schema-conforming data to the custom application. For more information about hosting the InfoPath editor, see the MSDN articles Hosting the InfoPath 2007 Form Editing Environment in a Custom Windows Form Application and Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form.

To create a data connection for submitting data to a hosting environment, use the Data Connections command on the Tools menu.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.

Example

The following is an example of the submitToHostAdapter element:

  <xsf:dataAdapters>
   <xsf:submitToHostAdapter name="HostSubmit" submitAllowed="yes"></xsf:submitToHostAdapter>
</xsf:dataAdapters>