DataObjects.Item Property

  • Article
InfoPath Developer Reference

A read-only property that returns a reference to the specified DataObject object from the DataObjects collection. Read-only

Version Information
 Version Added:  InfoPath 2003

Syntax

expression.Item(varIndex)

expression   An expression that returns a DataObjects object.

Parameters

Name Required/Optional Data Type Description
varIndex Required Variant An expression that specifies the position of a member of the DataObjects collection. If a numeric expression, the argument must be a number from 0 to the value of the collection's Count property minus 1. If a string expression, the argument must be the name of a member of the collection.

Return Value
DataObject

Remarks

If the value provided for the

varindex

argument does not match any existing member of the collection, an error occurs.

After you have set a reference to the DataObject object that the Item property returns, you can access any of its properties or methods.

Security Level 2: Can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

Example

In the following example, the Item property of the DataObjects collection is used to return a reference to a DataObject object:

JScript 
  var objDataObject;
objDataObject = XDocument.DataObjects.Item(0);

Because the Item property is the default property of the DataObjects collection, it can also be used as follows:

JScript 
  var objDataObject;
objDataObject = XDocument.DataObjects(0);

You can also use the name of the DataObject object as the argument to the Item method, as shown in the following example:

JScript 
  var objDataObject;
objDataObject = XDocument.DataObjects("MyDataObject");

See Also