Originally Posted On: https://ironsoftware.com/csharp/excel/tutorials/how-to-read-excel-file-csharp/
This tutorial explains how to read an Excel file in C# and using libraries for everyday tasks like validation, conversion to a database, saving data from Web APIs, and modifying formulae within the spreadsheet. This article references the IronXL code samples, which is a .NET Core Console App.
Reading and creating Excel files in C# and all other .NET languages is easy using the IronXL software library.
It does not require Excel to be installed on your server or Interop. IronXL provides a faster and more intuitive API than Microsoft.Office.Interop.Excel.
OverviewRead Excel files in C# by following these steps (CSV XLSX & XLS)- Download the Read CSV Excel File C# Library
- Load and read an Excel file (workbook)
- Create an Excel workbook in CSV or XLSX
- Enable cells and edit cell values in
- Validate spreadsheet data
- Export data using Entity Framework
IronXL is a .NET library that facilitates reading and editing Microsoft Excel documents with C#. This tutorial will walk you through using C sharp code to read the Excel file.
- Install the IronXL Excel Library. We can do this using our NuGet package or by downloading the .Net Excel DLL.
- Use the WorkBook.Load method to read any XLS, XLSX or CSV document.
- Get Cell values using intuitive syntax: sheet[“A11”].DecimalValue
- Dedicated product support from our .NET engineers
- Easy installation via Microsoft Visual Studio
- 30 day free trial test for development. Licenses from $399.
We will see how easy it is to read Excel files in C# or VB.Net using the IronXL library. The samples contain three Excel sheets.
Read XLS or XLSX Files: Quick Code
In this example we can see how to read the excel file efficiently without Interop in C#. The final Advanced Operations show Linq compatibility and aggregate range mathematics.
- /**
- Read XLS or XLSX File
- anchor-read-an-xls-or-xlsx-file
- **/
- using IronXL;
- using System.Linq;
- //Supported spreadsheet formats for reading include: XLSX, XLS, CSV and TSV
- WorkBook workbook = WorkBook.Load(“test.xlsx”);
- WorkSheet sheet = workbook.WorkSheets.First();
- //Select cells easily in Excel notation and return the calculated value
- int cellValue = sheet[“A2”].IntValue;
- // Read from Ranges of cells elegantly.
- foreach (var cell in sheet[“A2:A10”])
- {
- Console.WriteLine(“Cell {0} has value ‘{1}'”, cell.AddressString, cell.Text);
- }
- ///Advanced Operations
- //Calculate aggregate values such as Min, Max and Sum
- decimal sum = sheet[“A2:A10”].Sum();
- //Linq compatible
- decimal max = sheet[“A2:A10”].Max(c => c.DecimalValue);
Copy code to clipboardVB C#
Step 11. Download the IronXL C# Library for FREEDownload DLLManually install into your project
or
Install with NuGetInstall-Package IronXL.Excelnuget.org/packages/IronXL.Excel/
The first thing we need to do is install the IronXL.Excel library, adding Excel functionality to the .NET framework.
Installing IronXL.Excel, is most easily achieved using our NuGet package, although you may also choose to manually install the DLL to your project or to your global assembly cache.
Installing the IronXL Nuget Package- In Visual Studio, right-click on the project select “Manage Nuget Packages …”
- Search for the IronXL.Excel package and install
Another way to install is:
- Enter the Package Manager Console
- Type > Install-Package IronXL.Excel
PM > Install-Package IronXL.Excel
Additionally, you can view the package on the NuGet site here.
Direct Download InstallationAlternatively, we can start by downloading the IronXL .NET Excel DLL and manually installing into Visual Studio.
How To Tutorials2. Load a WorkBook
The WorkBook class represents an Excel sheet. To open an Excel File using C#, we use WorkBook.Load and specify the path of the Excel file (.xlsx).
- /**
- Load WorkBook
- anchor-load-a-workbook
- **/
- var workbook = WorkBook.Load(@”Spreadsheets\GDP.xlsx”);
Copy code to clipboardVB C#
Sample: ExcelToDBProcessor
Each WorkBook can have multiple WorkSheet objects. These represent worksheets in the Excel document. If the sheet contains worksheets, retrieve them by name WorkBook.GetWorkSheet.
- var worksheet = workbook.GetWorkSheet(“GDPByCountry”);
Copy code to clipboardVB C#
Sample: ExcelToDB
3. Create a WorkBook
To create a new WorkBook in memory, construct a new WorkBook with the sheet type.
- /**
- Create WorkBook
- anchor-create-a-workbook
- **/
- var workbook = new WorkBook(ExcelFileFormat.XLSX);
Copy code to clipboardVB C#
Sample: ApiToExcelProcessor
Note: Use ExcelFileFormat.XLS for legacy for Microsoft Excel spreadsheets (95 and earlier).
4. Create a WorkSheet
Each “WorkBook” can have multiple WorkSheets. A “WorkSheet” is a sheet of data, while a WorkBook represents a collection of WorkSheets. This is how one workbook with two worksheets looks in Excel.
To create a new WorkSheet call WorkBook.CreateWorkSheet and pass the name of the worksheet.
- var worksheet = workbook.CreateWorkSheet(“Countries”);
Copy code to clipboardVB C#
5. Get Cell Range
The “Range” class represents a two-dimensional collection of “Cell” objects. It represents a literal range of Excel cells. Obtain ranges by using the string indexer on a WorkSheet object.
The argument text is either the coordinate of a cell (e.g. “A1”) or a span of cells from left to right top to bottom (e.g. “B2:E5”). It is also possible to call GetRange on a WorkSheet.
- var range = worksheet[“D2:D101”];
Copy code to clipboardVB C#
Sample: DataValidation
6. Edit Cell Values Within a Range
There are several ways to read or edit the values of cells within a Range. If the count is known, use a For loop.
- /**
- Edit Cell Values in Range
- anchor-edit-cell-values-within-a-range
- **/
- //Iterate through the rows
- for (var y = 2; y <= 101; y++)
- {
- var result = new PersonValidationResult { Row = y };
- results.Add(result);
- //Get all cells for the person
- var cells = worksheet[$”A{y}:E{y}”].ToList();
- //Validate the phone number (1 = B)
- var phoneNumber = cells[1].Value;
- result.PhoneNumberErrorMessage = ValidatePhoneNumber(phoneNumberUtil, (string)phoneNumber);
- //Validate the email address (3 = D)
- result.EmailErrorMessage = ValidateEmailAddress((string)cells[3].Value);
- //Get the raw date in the format of Month Day[suffix], Year (4 = E)
- var rawDate = (string)cells[4].Value;
- result.DateErrorMessage = ValidateDate(rawDate);
- }
Copy code to clipboardVB C#
Sample: DataValidation
7. Validate Spreadsheet Data
Use IronXL to validate a sheet of data. The DataValidation sample uses libphonenumber-csharp to validate phone numbers and uses standard C# APIs to validate email addresses and dates.
- /**
- Validate Spreadsheet Data
- anchor-validate-spreadsheet-data
- **/
- //Iterate through the rows
- for (var i = 2; i <= 101; i++)
- {
- var result = new PersonValidationResult { Row = i };
- results.Add(result);
- //Get all cells for the person
- var cells = worksheet[$”A{i}:E{i}”].ToList();
- //Validate the phone number (1 = B)
- var phoneNumber = cells[1].Value;
- result.PhoneNumberErrorMessage = ValidatePhoneNumber(phoneNumberUtil, (string)phoneNumber);
- //Validate the email address (3 = D)
- result.EmailErrorMessage = ValidateEmailAddress((string)cells[3].Value);
- //Get the raw date in the format of Month Day[suffix], Year (4 = E)
- var rawDate = (string)cells[4].Value;
- result.DateErrorMessage = ValidateDate(rawDate);
- }
Copy code to clipboardVB C#
The above code loops through each row in the spreadsheet and grabs the cells as a list. Each validates method checks the value of a cell and returns an error message if the value is invalid.
This code creates a new sheet, specifies headers, and outputs the error message results so that there is a log of invalid data.
- var resultsSheet = workbook.CreateWorkSheet(“Results”);
- resultsSheet[“A1”].Value = “Row”;
- resultsSheet[“B1”].Value = “Valid”;
- resultsSheet[“C1”].Value = “Phone Error”;
- resultsSheet[“D1”].Value = “Email Error”;
- resultsSheet[“E1”].Value = “Date Error”;
- for (var i = 0; i < results.Count; i++)
- {
- var result = results[i];
- resultsSheet[$”A{i + 2}”].Value = result.Row;
- resultsSheet[$”B{i + 2}”].Value = result.IsValid ? “Yes” : “No”;
- resultsSheet[$”C{i + 2}”].Value = result.PhoneNumberErrorMessage;
- resultsSheet[$”D{i + 2}”].Value = result.EmailErrorMessage;
- resultsSheet[$”E{i + 2}”].Value = result.DateErrorMessage;
- }
- workbook.SaveAs(@”Spreadsheets\PeopleValidated.xlsx”);
Copy code to clipboardVB C#
8. Export Data using Entity Framework
Use IronXL to export data to a database or convert an Excel spreadsheet to a database. The ExcelToDB sample reads a spreadsheet with GDP by country and then exports that data to an SQLite.
It uses EntityFramework to build the database and then export the data line by line.
Add the SQLite Entity Framework NuGet packages.
EntityFramework allows you to create a model object that can export data to the database.
- public class Country
- {
- [Key]
- public Guid Key { get; set; }
- public string Name { get; set; }
- public decimal GDP { get; set; }
- }
Copy code to clipboardVB C#
To use a different database, install the corresponding NuGet package and find the equivalent of UseSqLite()
- /**
- Export Data using Entity Framework
- anchor-export-data-using-entity-framework
- **/
- public class CountryContext : DbContext
- {
- public DbSet<Country> Countries { get; set; }
- public CountryContext()
- {
- //TODO: Make async
- Database.EnsureCreated();
- }
- /// <summary>
- /// Configure context to use Sqlite
- /// </summary>
- /// <param name=”optionsBuilder”></param>
- protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
- {
- var connection = new SqliteConnection($”Data Source=Country.db”);
- connection.Open();
- var command = connection.CreateCommand();
- //Create the database if it doesn’t already exist
- command.CommandText = $”PRAGMA foreign_keys = ON;”;
- command.ExecuteNonQuery();
- optionsBuilder.UseSqlite(connection);
- base.OnConfiguring(optionsBuilder);
- }
- }
Copy code to clipboardVB C#
Create a CountryContext, iterate through the range to create each record, and then SaveAsync to commit data to the database
- public async Task ProcessAsync()
- {
- //Get the first worksheet
- var workbook = WorkBook.Load(@”Spreadsheets\GDP.xlsx”);
- var worksheet = workbook.GetWorkSheet(“GDPByCountry”);
- //Create the database connection
- using (var countryContext = new CountryContext())
- {
- //Iterate through all the cells
- for (var i = 2; i <= 213; i++)
- {
- //Get the range from A-B
- var range = worksheet[$”A{i}:B{i}”].ToList();
- //Create a Country entity to be saved to the database
- var country = new Country
- {
- Name = (string)range[0].Value,
- GDP = (decimal)(double)range[1].Value
- };
- //Add the entity
- await countryContext.Countries.AddAsync(country);
- }
- //Commit changes to the database
- await countryContext.SaveChangesAsync();
- }
- }
Copy code to clipboardVB C#
Sample: ExcelToDB
9. Add Formula to a Spreadsheet
Set formula of Cell‘s with the Formula property.
The code below iterates through each state and puts a percentage total in column C.
- /**
- Add Spreadsheet Formulae
- anchor-add-formulae-to-a-spreadsheet
- **/
- //Iterate through all rows with a value
- for (var y = 2; y < i; y++)
- {
- //Get the C cell
- var cell = sheet[$”C{y}”].First();
- //Set the formula for the Percentage of Total column
- cell.Formula = $”=B{y}/B{i}”;
- }
Copy code to clipboardVB C#
Sample: AddFormulaeProcessor
10. Download Data from an API to Spreadsheet
The following call makes a REST call with RestClient.Net. It downloads JSON and converts it into a “List” of the type RestCountry. It is then easy to iterate through each country and save the data from the REST API to an Excel spreadsheet.
- /**
- Data API to Spreadsheet
- anchor-download-data-from-an-api-to-spreadsheet
- **/
- var client = new Client(new Uri(“https://restcountries.eu/rest/v2/”));
- List<RestCountry> countries = await client.GetAsync<List<RestCountry>>();
Copy code to clipboardVB C#
Sample: ApiToExcel
This is what the API JSON data looks like.
The following code iterates through the countries and sets the Name, Population, Region, NumericCode, and Top 3 Languages in the spreadsheet.
- for (var i = 2; i < countries.Count; i++)
- {
- var country = countries[i];
- //Set the basic values
- worksheet[$”A{i}”].Value = country.name;
- worksheet[$”B{i}”].Value = country.population;
- worksheet[$”G{i}”].Value = country.region;
- worksheet[$”H{i}”].Value = country.numericCode;
- //Iterate through languages
- for (var x = 0; x < 3; x++)
- {
- if (x > (country.languages.Count – 1)) break;
- var language = country.languages[x];
- //Get the letter for the column
- var columnLetter = GetColumnLetter(4 + x);
- //Set the language name
- worksheet[$”{columnLetter}{i}”].Value = language.name;
- }
- }
Copy code to clipboardVB C#
Object Reference and Resources
You may also find the IronXL class documentation within the Object Reference of great value.
In addition, there are other tutorials which may shed light in other aspects of IronXL.Excel including Creating, Opening, Writing Editing, Saving and Exporting XLS, XLSX and CSV files without using Excel Interop..
SummaryIronXL.Excel is alone .Net software library for reading a wide variety of spreadsheet formats. It does not require Microsoft Excel to be installed, and is not dependant on Interop.
11. Watch the Read Excel File C# Tutorial Video