Load¶

Loads XML content into the current node from the $XmlRepository.

myXml.Load(xquery: string, parameters?: object, collection?: string):void

Parameters¶

string xquery
XQuery expression to perform to select the content to load.

object parameters optional
If the XQuery has binding parameters, this argument specifies a dictionary of parameter values.

string collection optional
Optional collection name within the $XmlRepository to load from.

Remarks¶

This method only loads elements that match the node's XML schema. Non-matching elements are ignored. The repository result is first merged under an element matching the current node, then copied into the current navigator. This is a destructive update of the current node's content, not a read-only query. Registered namespace prefixes are implicitly declared while performing the XQuery. When an XQuery is supplied, braces in the current XML are escaped before it is passed to the query engine. The method saves every returned XML fragment to targetXPath (or the current node's local name) and returns those saved fragments.

If the resulting query returns the same node name as the current node's name, the current node's inner XML is replaced with the result. Otherwise, the resulting nodes are processed as child nodes of the current node.

For more XQuery details, please refer to the XQuery+standard and XQuery+Update standards.

Saving & Loading¶

$Xml.Save('','Settings'); // save current node
$Xml.Load('Settings/*'); // load current node contents

Loading a simple result to the current node¶

$Xml.Load('Person[Id=1]');

Loading a basic transformed result to the current node¶

$Xml.Load('for $c in //Person                         ' +
   'where $c/Surname                                  ' +
   'return                                            ' +
   '  <Person>                                        ' +
   '    <Name>{ $c/Name }</Name>                      ' +
   '  <Person>                                        ');