Name

xmlmaps.Add(Schema, [RootElementName])

Synopsis

Creates a new XML map and adds it to a workbook. Returns the XML map created.

Argument

Settings

Schema

The name of an XML schema file, XML datafile, schema data, or XML data to base the XML map on.

RootElementName

If the schema contains more than one root element, this is the name of the root element to use for the XML map. Otherwise, this argument can be omitted.

Excel names XML maps by appending _Map to the name of the root element of the schema. If an XML map with that name already exists, Excel adds a number to the new name.

The Schema argument is very flexible. It can contain a filename as a UNC or URL or it can contain the data for the schema in string format. If the Schema argument is XML data, rather than an XML schema, Excel infers a schema from that data. For example, the following code infers a schema from some XML data supplied as a string and creates a new XML map named Numbers_Map:

xml = "<Numbers><Number><One /><Two /><Three /></Number>" & _
  "<Number /></Numbers>"
Set xmap = ThisWorkbook.XmlMaps.Add(xml)

Get Programming Excel with VBA and .NET now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.