DataSourceObject Interface

Definition

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Represents a secondary data source.

public interface class DataSourceObject : Microsoft::Office::Interop::InfoPath::DataObject

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

type DataSourceObject = interface
    interface DataObject

Public Interface DataSourceObject
Implements DataObject

Derived

Microsoft.Office.Interop.InfoPath.DataSourceObjectClass

Attributes

GuidAttribute

Implements

DataObject

Remarks

This type is a wrapper for a coclass that is required by managed code for COM interoperability. Use this type to access the members of the COM interface implemented by this coclass. For information about the COM interface, including a link to descriptions of its members, seeDataObject.

The DataObject object corresponds to stored data, obtained from some external source of data, using an associated data adapter. It provides properties and methods that can be used to programmatically interact the stored data, as well as providing access to the associated data adapter object. The DataObject object is accessible through the DataObjects property of the XDocument object.

The DataObject object acts as an intermediary between a Microsoft InfoPath form and the data adapter object that is used to obtain data from an external connection, such as a connection to a Microsoft Access or Microsoft SQL Server database, an .xml file, or an XML Web service. The type of data adapter object used depends on the type of external data connection. The DataObject object provides a common set of properties and a method that can be used for all types of data adapter objects, and each of the data adapter objects provides its own set of properties and methods.

Microsoft InfoPath supports four types of data adapters:

• ActiveX Data Objects Represented by the ADOAdapterObject object.
• SharePoint list Represented by the SharepointListAdapterObject object.
• Web services Represented by WebServiceAdapterObject object.
• XML file Represented by XMLFileAdapterObject object.

Properties

DOM	Gets a reference to an XML Document Object Model (DOM) that is associated with a DataSourceObject object. (Inherited from DataObject)
Name	Gets the name of the associated DataSourceObject object. (Inherited from DataObject)
QueryAdapter	Gets a reference to the data adapter object that is used for a secondary data source. (Inherited from DataObject)

Methods

Query()

Executes the query operation on the data adapter associated with the DataSourceObject object, and inserts the returned XML in the associated data source (XML DOM). (Inherited from DataObject)