_Workbook.XmlImportXml(String, XmlMap, Object, Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Imports an XML data stream that has been previously loaded into memory. Returns XlXmlImportResult.
public Microsoft.Office.Interop.Excel.XlXmlImportResult XmlImportXml (string Data, out Microsoft.Office.Interop.Excel.XmlMap ImportMap, object Overwrite, object Destination);
Public Function XmlImportXml (Data As String, ByRef ImportMap As XmlMap, Optional Overwrite As Object, Optional Destination As Object) As XlXmlImportResult
Parameters
- Data
- String
Required String. The data to import.
- Overwrite
- Object
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
- Object
Optional Range. The data will be imported into a new XML list in the range specified.
Returns
Remarks
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.
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.
Use the XmlImport(String, XmlMap, Object, Object) method of the Workbook object to import an XML data file into the current workbook.