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 XMLAdapterTables 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.

See Also

Reference

RespectNesting Property
NestedInto Property
NextSiblingTable Property
FirstNestedTable Property
XMLTable Class

Other Resources

Methods (Visual FoxPro)