Show AllShow All

SharepointListAdapter Object

Represents a connection to a SharePoint list or document library. The SharePointListAdapter object represents the Office InfoPath 2003 data adapter for retrieving data from a SharePoint list or document library.

Remarks

Note  This object model member is not supported when the Disable Service Pack features option on the Advanced tab of the Options dialog box in InfoPath is selected or when Microsoft Office 2003 Service Pack 1 or later is not installed. Any form that implements this object model member in its code will generate an error message if it is opened in InfoPath when service pack features are disabled or unavailable.

Using the SharepointListAdapter Object

For a secondary data source, the SharePointListAdapter object is accessible through the QueryAdapter property of a data adapter object. Data adapter objects are accessible through the DataObjects collection of the XDocument object.

The SharepointListAdapter object contains the following properties:

PropertyDescription
NameReturns the name of the SharepointListAdapter object.
QueryAllowedA read-only property of type Boolean that corresponds to the queryAllowed attribute in the form definition file (.xsf). Always returns True for the SharepointListAdapter object.
SiteUrlA read-only property returning the Uniform Resource Locator (URL) of the SharePoint site that this adapter can query from.
SubmitAllowedCorresponds to the submitAllowed attribute in the form definition file (.xsf). Always returns False for the SharepointListAdapter object.

The SharepointListAdapter object contains the following methods:

MethodDescription
QueryReads data from the SharepointListAdapter object.
SubmitBecause the SharepointListAdapter object is available for receiving data only, this method will always generate a run-time error when it is called on that object.

Example

In the following example, a reference to the SharePointListAdapter object is accessed through the QueryAdapter property of a data adapter object by passing the name of the data adapter object to the Item property of the DataObjects collection:

var objSPLAdapter;
objSPLAdapter = XDocument.DataObjects("Contacts").QueryAdapter;

After the reference has been set, you can use the methods of the SharePointListAdapter object as shown in the following example, which requeries the SharePoint list or library to update the DOM property of the data object:

objSPLAdapter.Query();
©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp