Introduction
Often we are in a need to convert Excel data to XML stream/XML file which can be used as a feed to various applications like web services or middle tiers such as BizTalk 2004. There will be many situations where we need to validate the format of Excel data sheet against a specified XML schema. We will also be required to generate XML schema based on an Excel Work Sheet. This utility along with the library will help you to accomplish the same.
The following are the salient features of this library:
- Usage of Microsoft Jet Engine to connect to Excel.
- Conversion of Excel Worksheet/Workbook to XML file and XML Schema.
- Generation of XML file and XML Schema based on provided range.
- Validation of Excel Worksheet/Workbook against the provided XML Schema.
- Provision of batch processing capability.
In this article, we will discuss the implementation of the library functions. The library contains the core functionality to access and manipulate Excel data.
The utility will merely call the appropriate functions from the library. In this way, one can use this same library in ASP.NET applications also with minute changes.
Connectivity Options
There are two ways to manipulate an Excel file. It can be done either by using Microsoft Office Component (check out here) or with Microsoft Jet Engine.
As per Microsoft recommendation, it is not advisable to use Office components on the server. It means that if you want to use this library for a server application, it�s not a good idea to use the Office component. So the connection will be done using Jet Engine.
Connection to Excel using Jet Engine
To connect to Excel, one can use OleDb objects that will treat Excel as a database, and then the required information can be easily fetched by using SQL queries. The important steps that have to be considered while connecting to Excel are as follows:
- Connection String:
The connection string should be set to the OleDbConnection object. This is very critical as Jet Engine might not give a proper error message if the appropriate details are not given.
Syntax: Provider=Microsoft.Jet.OLEDB.4.0;Data Source=<Full Path of Excel File>; Extended Properties="Excel 8.0; HDR=No; IMEX=1".
- Definition of Extended Properties:
Excel = <No>
One should specify the version of Excel Sheet here. For Excel 2000 and above, it is set it to Excel 8.0 and for all others, it is Excel 5.0.
HDR= <Yes/No>
This property will be used to specify the definition of header for each column. If the value is �Yes�, the first row will be treated as heading. Otherwise, the heading will be generated by the system like F1, F2 and so on.
IMEX= <0/1/2>
IMEX refers to IMport EXport mode. This can take three possible values.
IMEX=0 and IMEX=2 will result in ImportMixedTypes being ignored and the default value of �Majority Types� is used. In this case, it will take the first 8 rows and then the data type for each column will be decided.
IMEX=1 is the only way to set the value of ImportMixedTypes as Text. Here, everything will be treated as text.
For more info regarding Extended Properties, check this out.
Loading of data in to Dataset
After successfully connecting to Excel using Jet Engine, it is easy to the load the data in to DataSet. One has to write a query similar to ANSI-92 with the only changes being that each Excel sheet will be treated as a table and the table name will be the sheet name with �$�. The range can also be specified after the �$� sign.
public DataTable GetDataTable(string strSheetName)
{
try
{
string strComand;
if(strSheetName.IndexOf("|") > 0)
{
SheetName = strSheetName.Substring(0,strSheetName.IndexOf("|"));
Range = strSheetName.Substring(strSheetName.IndexOf("|")+1);
strComand="select * from ["+SheetName+"$"+Range+"]";
}
else
{
strComand="select * from ["+strSheetName+"$]";
}
daAdapter=new OleDbDataAdapter(strComand,cn);
DataTable dt=new DataTable(strSheetName);
daAdapter.FillSchema(dt,SchemaType.Source);
daAdapter.Fill(dt);
cn.Close();
return dt ;
}
catch(Exception ex)
{
throw new Exception(ex.Message);
}
}
Conversion of Dataset to XML data and XML Schema
After loading the data in to DataSet, GetXML and GetXMLSchema functions will be used to generate XML data as well as XML Schema. This tool can also be used to generate a single file with XML Schema and XML data together. But this should not be done as XML schema is also an XML data. The following code snippet shows the same which should be avoided at any cost.
public string GetXML(string strSheetName, Boolean _blnSchema)
{
DataSet ds=new DataSet();
ds.Tables.Add(this.GetDataTable(strSheetName));
if(_blnSchema)
return ds.GetXmlSchema()+ds.GetXml();
else
return ds.GetXml();
}
Validation against XML Schema
Once the data is generated in the form of XML, we can validate the same using the XmlValidatingReader object from System.Xml.Schema.
public string ValidateXML(string strSchemaFile,string WorkSheet)
{
strParseError="";
XmlParserContext context = new XmlParserContext(null,
new XmlNamespaceManager(new NameTable()),
null, XmlSpace.None);
XmlTextReader xmlReader = new XmlTextReader(this.GetXML(WorkSheet,
false), XmlNodeType.Element, context);
XmlValidatingReader objValidator = new XmlValidatingReader(xmlReader);
objValidator.ValidationType = ValidationType.Schema;
XmlSchemaCollection objSchemaCol = new XmlSchemaCollection();
objSchemaCol.Add("", strSchemaFile);
objValidator.Schemas.Add(objSchemaCol);
objValidator.ValidationEventHandler +=
new ValidationEventHandler(ShowCompileErrors);
try
{
while (objValidator.Read()) { }
}
catch(Exception objError)
{
throw new Exception(objError.Message);
}
finally
{
xmlReader.Close();
}
return strParseError;
}
private void ShowCompileErrors(object sender, ValidationEventArgs args)
{
strParseError+="::"+args.Message+"\r\n" ;
}
Batch Process
Batch process will take the array of strings, and then by using the above functions will generate XML file and Schema per Workbook.
Future Enhancements
Generation of Excel Worksheet based on given XML Schema.
Download Binaries
You can download the working application here [9.48 Kb].
History
- Version 1.0 released on 3rd June, 2005.
