Nest Method
Nests an XMLTable object into a specified XMLTable.
XMLTable.Nest(oXMLTable [, oAfterXMLTable | nAfterIndex])
Parameters
oXMLTable
Object reference to the XMLTable object to nest.oAfterXMLTable
Object reference to the XMLTable object to insert oXMLTable after.nAfterIndex
Integer indicating which existing XMLTable object to insert oXMLTable after.nAfterIndex
Setting
A number that is less than or equal to the number of nested XLMTables.
oXMLTable is inserted after the XLMTable object within the specified index.
A number that is greater than the number of nested tables.
oXMLTable is inserted as the last nested table.
-1
oXMLTable is inserted as the last nested table.
0
oXMLTable is inserted as the first nested table.
unspecified
oXMLTable is inserted as the last nested table.
Remarks
Applies to: XMLTable Class
The oXMLTable parameter and the oAfterXMLTable parameters must reference XMLTable objects that are members of the same XMLAdapter Tables collection.
The nAfterTable parameter must be greater than or equal to -1.
If you remove a nested XMLTable object from an XMLAdapter Tables collection, the XMLTable object's NestedInto, NextSiblingTable and FirstNestedTable properties are automatically set to null (.NULL.). All of its child XMLTable objects are disconnected from it, and their NestedInto and NextSiblingTable properties are set to null (.NULL.). The child objects remain in the collection but are no longer nested.
If an XMLTable object is nested at the time the Nest method is called, it is unnested before its new position is calculated.
For more information about how XML parsing and generation is affected by XLMTable nesting, see RespectNesting Property and XMLAdapter Class.