Share via


XmlImport Method [Excel 2003 VBA Language Reference]

Note  XML features, except for saving files in the XML Spreadsheet format, are available only in Microsoft Office Professional Edition 2003 and Microsoft Office Excel 2003.

XlXmlImportResult

XlXmlImportResult can be one of the following XlXmlImportResult constants
xlXmlImportElementsTruncated The contents of the specified XML data file have been truncated because the XML data file is too large for the worksheet.
xlXmlImportSuccess The XML data file was successfully imported.
xlXmlImportValidationFailed The data being imported failed schema validation, but was imported anyway.

expression**.XmlImport(Url**, ImportMap, Overwrite, Destination)

expression Required. An expression that returns one of the objects in the Applies To list.

Url  Required String. A uniform resource locator (URL) or a uniform naming convention (UNC) path to a XML data file.

ImportMap  Required XmlMap. The schema map to apply when importing the file. If the data was previously imported, contains a reference to the XmlMap object containing the data.

Overwrite   Optional Boolean. If a value is not specified for the Destination parameter, then this parameter specifies whether or not to overwrite data that has been mapped to the schema map specified in the ImportMap parameter. Set to True to overwrite the data or False to append the new data to the existing data. The default value is True. If a value is specified for the Destination parameter, then this parameter specifies whether or not to overwrite existing data. Set to True to overwrite existing data or False to cancel the import if data would be overwritten. The default value is True.

Destination   Optional Range. Specifies the range where the list will be created. You only use the top left corner of the range.

Remarks

This method allows you to import data into the workbook from a file path. Excel uses the first qualifying map found, or if the destination range is specified, Excel will automatically list the data.

Don't specify a value for the Destination parameter if you want to import data into an existing mapping.

The following conditions will cause the XMLImport method to generate run-time errors:

  • The specified XML data contains syntax errors.
  • The import process was cancelled because the specified data cannot fit into the worksheet.
  • If no qualifying maps are found and the destination range was not specified.

Use the XmlImportXml method of the Workbook object to import XML data that has been previously loaded into memory.

Applies to | Workbook Object