ItemAdd

Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.

SalNumber ItemAdd( SalString sItemName,
	 SalString<SalArray> sItemValues )

The ItemAdd method adds an item (column) to an already initialized DataTransfer object.

Parameters

Name Description
SalString sItemName Name of the item to be added.
SalString<SalArray> sItemValues All values for the item to be added. The number of values for the item being added must match the number of records (rows) currently in the DataTransfer object.

Returns

This method does not return a value.

Comments

The ItemAdd method must be called after a call to Init, InitFromObjConRef, or SourceNameSet.

Furthermore, the number of values for the item being added must match the number of records (rows) currently in the DataTransfer object.