New (XmlNodelist constructor)

Create XmlDoc/XmlNodelist object

New is a member of the XmlDoc and XmlNodelist classes.

This method creates an XmlDoc or XmlNodelist object instance. If used to create an XmlDoc, it takes no arguments. If used to create an XmlNodelist, it takes one argument: the XmlDoc with which the XmlNodelist is associated.

Syntax

  %xmldoc = New

  %xmlnlis = New(%doc)

Syntax Terms

%xmldoc

A declared XmlDoc object variable to contain the new XmlDoc object instance.

%xmlnlis

A declared XmlNodelist object variable to contain the new XmlNodelist object instance.

%doc

A XmlDoc object variable which references the XmlDoc with which %xmlnlis is associated.

Usage Notes

• New can be invoked with no object (as in the syntax box above), or alternatively as shown below, with an explicit class name or with an object variable (even if that object is null):

      %xmldoc = %(XmlDoc):new
  
      %xmlnlis = %xmlnlis:new(%doc)
  

• Besides explicit New statements, XmlNodelists can be created by other XML methods (for example, see SelectNodes, ?? reftxt=UnionSelected refid=unionsl., and ?? reftxt=Difference refid=diff.). An XmlDoc can only be instantiated by the New method, although an XmlDoc can be returned or duplicated by a method (see ?? reftxt=XmlDoc refid=xdocfn. and ?? reftxt=Copy refid=copydoc.).