Sharing the goodness…
Beth Massi is a Senior Program Manager on the Visual Studio team at Microsoft and a community champion for business application developers. Learn more about Beth.
More videos »
One really handy thing to do with relational data is to import and export it to Excel. This can be a total snap using LINQ to XML in Visual Basic 2008. For example, let's say I want to import data from an Excel spreadsheet into a local database file like SQL Compact Edition. I also want to be able to export that data back into an Excel spreadsheet, basically allowing me to edit the data from either my application or Excel.
The trick really is getting the format of the Excel spreadsheet as XML and using that sheet as a template to populate your data. First open Excel (for this example I'll use the Excel 2003 format so you can use Excel 2007 or 2003 to follow along). Next let's enter some column headers, for my example I have a list of customers I want to import/export so the fields I'll want are Abbrev, Name, Phone, Country. It's also helpful to enter one line of dummy data (you'll see why in a second). So here' what we've got:
Now what I want to do is get all the customers stored in my little SQL CE local database into this spreadsheet.
(As a side note, you can easily add a SQL CE local database file to your project by selecting the "Local Database" new item template in Visual Studio 2008. You can easily access the data in SQL CE sdf files by adding a new datasource (Data --> Add New Datasource), adding a new connection, and change the data source to "Microsoft Compact SQL Server 3.5" then locate or create the .sdf file. Then you can create typed Datasets like normal.)
So I have a form where I just dragged my CustomersDataSet that I created from my local database file onto it as a DataGridView. This also sets up the BindingSource and BindingNavigator toolstrip like we'd expect. I added a couple buttons to the toolstrip one called "Import" and one called "Export".
Now in order to get the Excel spreadsheet into an XML format you can simply "Save As.." and select "XML Spreadsheet 2003 (.xml)" as the file type. Now navigate to that file and open it with notepad, select and copy all the text into your clipboard. Open up your Visual Basic program, type "Dim sheet =" and then paste the contents of your clipboard directly into the editor. It should look something like this (I collapsed some of the sections we're going to ignore):
Next we need to import the namespaces in the spreadsheet. This is necessary so that when we create and query our XML, Visual Basic will know the correct namespaces we're working with. So at the top of code file for our form we'll add:
Imports <xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet">Imports <xmlns:html="http://www.w3.org/TR/REC-html40">
Now we can write a query that will take all of the customers in our SQL CE database file (technically the typed DataSet that was created for us) and populate the spreadsheet. You should see your dummy data in the XML above. Cut that out (ctrl-X) because we're going to replace that with all our customers using embedded expressions like so:
Dim customers = _
From customer In Me.CustomersDataSet.Customers _
Where customer.RowState <> DataRowState.Deleted _
AndAlso Not customer.IsAbbrevNull _
Order By customer.Abbrev _
<Cell><Data ss:Type="String"><%= customer.Abbrev %></Data></Cell>
<Cell><Data ss:Type="String"><%= If(customer.IsNameNull, "", customer.Name)%> </Data></Cell>
<Cell><Data ss:Type="String"><%= If(customer.IsPhoneNull, "", customer.Phone)%> </Data></Cell>
<Cell><Data ss:Type="String"><%= If(customer.IsCountryNull, "",customer.Country)%> </Data></Cell>
I'm just selecting the data inside my typed Dataset which is populated in the load of the form, making sure not to grab any deleted rows or rows where the abbreviation is NULL. The customers variable above becomes a collection of XElements (IEnumerable(Of XElement)) and we simply pop that back into the sheet, replacing the dummy line we removed:
<Table ss:ExpandedColumnCount="4" ss:ExpandedRowCount=<%= customers.Count + 1 %> x:FullColumns="1" x:FullRows="1" ss:DefaultRowHeight="15">
<%= customers %>
Also notice that I had to adjust the ss:ExpandedRowCount attribute as well to include the count of our customers plus one for the header row. Now we can write the results out to disk and start Excel:
Okay so now we want to be able to import this data as well. If any rows were added or edited we want that data back in our database. I'm going to use the Abbrev field as the unique identifier of our data. The query we need to write will group join (outer join) the current (non-deleted) rows in our CustomerDataSet to the rows here in the spreadsheet. That way if the resulting items in the collection contain a group (of one CustomerDataRow in this case), then we know that the CustomerDataRow needs to be updated, otherwise we know it's a new customer that needs to be added. We also need to skip the first row because that's our header row in the spreadsheet, and I'm doing an extra check for empty cells.
Dim sheet = XDocument.Load("C:\Customers.xml")
'Skip the first row because that is the header row in the spreadsheet.
'Notice also that we're eliminating deleted rows from the group join.
'We'll use the existence of the group collection to determine if the
' row needs to be added to the database.
Dim customers = From xmlCustomer In sheet...<Row> _
Let Abbrev = xmlCustomer.<Cell>(0) _
Let Name = xmlCustomer.<Cell>(1) _
Let Phone = xmlCustomer.<Cell>(2) _
Let Country = xmlCustomer.<Cell>(3) _
Abbrev IsNot Nothing AndAlso _
Name IsNot Nothing AndAlso _
Phone IsNot Nothing AndAlso _
Country IsNot Nothing _
Group Join customer In _
(From row In Me.CustomersDataSet.Customers _
Where row.RowState <> DataRowState.Deleted _
AndAlso Not row.IsAbbrevNull _
Select row) _
On customer.Abbrev Equals Abbrev _
Into Group _
Abbrev = Abbrev.Value, _
Name = Name.Value, _
Phone = Phone.Value, _
Country = Country.Value, _
'Add or update the customer row depending on if the
' group collection exists.
For Each customer In customers
Dim r As CustomersDataSet.CustomersRow
If customer.Group.Count = 0 Then
'Add new row ands set the customer abbreviation.
' This field is used to determine uniqueness of the data
r = Me.CustomersDataSet.Customers.NewCustomersRow()
r.Abbrev = customer.Abbrev
r = customer.Group(0)
r.Name = customer.Name
r.Phone = customer.Phone
r.Country = customer.Country
If r.RowState = DataRowState.Detached Then
Now we can make changes to the spreadsheet, import the data into our local database, or make changes to our local database and export those changes to Excel. I've attached the complete example built with Visual Basic 2008. You'll also need Excel 2003 or higher to view the spreadsheet. It's worth reiterating that you don't actually need Excel to create the spreadsheet in Visual Basic via code as long as you have the XML format, you just need it if you want to open it in Excel later. Remember we're not using automation, we're just creating XML in a specific format.
The second part of the example above does exactly that. Take a look at the attached code. Basically you'll need to agree on what identifies a unique row, in this example it's Abbrev.
I'll be speaking at the Victoria Code Camp on January 26th so if you're in the area and you have nothing
This looks exactly like what I'm looking for. With a couple of bugs worked out. I have not modified the code in the sample.
In testing, if I add a name to the spreadsheet (which will be important to me), on import, I get the error, "Cannot set column 'Abbrev'. The value violates the MaxLength limit of this column."
You'll either need to increase the width of the column in the database or limit the Abbrev field to 5 characters in the spreadsheet.
:) Thank you. Simple enough :)
How would you do this in C#? Please share.
I am hoping to build this so multiple users can add information and update the same table using a Windows Forms Application vs the Consul Application. Is there a good reference location for the code differences? Thank you.
XML Literals are not supported in C# so you would have to construct the document using the LINQ to XML API directly. It's pretty ugly but I think there may be a tool that helps you paste literals into the editor. I'd ask in the forums.
The example above (download the attachment to this post) is already a Windows Forms application. To make it multi-user capable you would need to use SQL-Server Express as the database instead of CE. Here are some How-To videos to help get you started: http://msdn2.microsoft.com/en-us/vbasic/bb466226.aspx#formsoverdata
I've been using Visual Web Developer 2008 Express Edition and SQL-Server Express as a database. Are there How -To videos for incorporating Linq to SQL / XML as a Web Application?
I am using the VB.net 2008, and I want to import my excel datas into my vb-program.. How can I made such importing from excel file into visual basic? Thanks!
I haven't watched them yet, but can check these videos out http://www.asp.net/learn/linq-videos/ and let us know.
The attached example to the post above shows importing and exporting Excel data.
Beth, thank you
The asp.net learning videos combined with yours are great.
Quickly. The spread sheet saves. The headers show up in excel but no data. I can see the data laid out in order if I view it as an xml feed in the browser.
I think its the count+1 addition to the spread sheet code. If I change this portion I get the error, "Compiler Error Message: BC30456: 'Count' is not a member of 'System.Xml.Linq.XElement'."
I'm trying to add 'count' as an included member. Any directing would be appreciated.
Thanks again, Kevin
Count is an extension method on the collection returned from the LINQ query above. It sounds like you are returning an XElement from your query.