New (XmlNodelist constructor)

From m204wiki
Revision as of 21:22, 9 February 2011 by JAL (talk | contribs) (removed <p> tag after subtitle template include - this was messing up the formatting of the *syntax* template)
Jump to navigation Jump to search

Create a new XmlNodelist (XmlNodelist class)


This method creates an XmlNodelist object instance and takes one argument: the XmlDoc with which the XmlNodelist is associated.

Syntax

%nodl = [%(XmlNodelist):]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.).

See also