DataTable in C# – Usage And Examples 🧪

bytehide

ByteHide

Posted on June 18, 2024

DataTable in C# – Usage And Examples 🧪

DataTables are an essential part of data handling in C#, but they can be quite tricky for beginners as well as those who haven’t used them often. So, ready to unravel the mysteries of C# DataTables? Let’s weather the storm together and emerge as DataTable champions!

Introduction: What Is DataTable

DataTable, in C#, is like a mini-database living in your computer’s memory, representing a single table of in-memory data. Isn’t it exciting to imagine a whole database in such a small space?

Understanding C# DataTable and Its Core Functionality

DataTable is part of ADO.NET, the data access model from Microsoft used in .NET framework. It represents a single table of data with a collection of columns and rows. DataTable can be standalone or part of a DataSet, which can hold multiple DataTable objects.

// Create a new DataTable
DataTable dt = new DataTable();
Enter fullscreen mode Exit fullscreen mode

Look, we just created a new DataTable!

Delving Into the Creation of a DataTable

Let’s take a deeper dive into the creation process of a DataTable. It’s just like baking, but instead of flour and eggs, we’re using columns and rows.

How to Create a DataTable

Creating a DataTable involves declaring a new instance of the DataTable class.

DataTable table = new DataTable("Customers");
Enter fullscreen mode Exit fullscreen mode

We’ve cooked up a new table called “Customers”. Who said programming can’t be fun!

Add Column to DataTable

Having a table is great but what’s a table without its columns?

table.Columns.Add("CustomerID", typeof(int));
table.Columns.Add("CustomerName", typeof(string));
Enter fullscreen mode Exit fullscreen mode

Like a proud chef, we’ve just added two columns to our Customers table!

Populating Your DataTable

Creating a table and adding columns is just the beginning. We’ll now add the lifeblood of a table – data!

Adding DataRow to DataTable

DataRow represents a single row in the DataTable. Here’s how to add them:

DataRow row = table.NewRow();
row["CustomerID"] = 1;
row["CustomerName"] = "John Doe";
table.Rows.Add(row);
Enter fullscreen mode Exit fullscreen mode

With these few lines of code, our Customer table has its first row of data!

DataTable and Row Addition: Building a C# DataTable from Scratch

Building a DataTable from scratch gives us an empty canvas to work with. Create the table, define the columns, and add rows to it. It’s like giving birth to a new table, isn’t it?

DataTable table = new DataTable("Orders");
table.Columns.Add("OrderID", typeof(int));
table.Columns.Add("OrderAmount", typeof(decimal));

DataRow row = table.NewRow();
row["OrderID"] = 101;
row["OrderAmount"] = 150.75m;
table.Rows.Add(row);
Enter fullscreen mode Exit fullscreen mode

With our nifty hands, we’ve made a new Orders table with one row of data! Isn’t C# amazing?

Learn to Manipulate DataTable in C#: From Simple to Complex Operations

Now that our DataTable is alive with data, let’s learn to play with it. A skillful magician never reveals his secrets, but here, we break the rules!

Getting Column Value from DataTable

Accessing column values from a DataRow is similar to accessing values from an array or a dictionary. See this neat trick:

DataRow row = table.Rows[0];
int orderId = row.Field<int>("OrderID");
decimal amount = row.Field<decimal>("OrderAmount");
Enter fullscreen mode Exit fullscreen mode

You know the feeling when you crack the secret code? This is it!

Iterating through DataTable

Running around the DataTable in circles, or in programming terms, iterating over the DataTable, is like a fun sport!

foreach (DataRow row in table.Rows){
  int orderId = row.Field<int>("OrderID");
  decimal amount = row.Field<decimal>("OrderAmount");
}
Enter fullscreen mode Exit fullscreen mode

What’s better than a victory lap? A lap around your DataTable!

Comparing DataTable’s Column Values

Often, you’ll need to compare DataTable column values. It’s like a little detective game, where variables are our clues.

Comparing Two DataTable Column Values in C#: A Practical Guide

Let’s find out how to compare column values from two different DataTables.

bool areEquals = dataTable1.AsEnumerable()
                    .SequenceEqual(dataTable2.AsEnumerable(), DataRowComparer.Default);
Enter fullscreen mode Exit fullscreen mode

Ah, the joy of finding the missing piece of the puzzle!

Select and Sort Operations

The ability to select or sort data is like a powerful magic spell that every C# programmer must learn!

C# Select from DataTable

Select operation is similar to a SQL SELECT query.

DataRow[] selectedRows = table.Select("OrderAmount > 100");
Enter fullscreen mode Exit fullscreen mode

Abracadabra! We have the rows with Order Amount greater than 100.

Sorting DataTable

Sorting is significant when dealing with a large amount of data. It’s like arranging your stuff in order.

table.DefaultView.Sort = "OrderAmount DESC";
table = table.DefaultView.ToTable();
Enter fullscreen mode Exit fullscreen mode

Just like magic, all our data is sorted in descending order of Order Amount!

Filtering and List Conversion

Enough chit-chat, let’s dive into the serious stuff – filtering data and converting DataTable to lists!

Filtering DataTable

Filtering is essential when working with massive datasets. It’s like going fishing with a good net.

DataRow[] result = table.Select("OrderAmount > 100 AND OrderAmount < 200");
Enter fullscreen mode Exit fullscreen mode

We’ve just caught all rows with Order Amount between 100 and 200!

List DataTable

Listing a DataTable allows us to handle and manipulate the data efficiently.

List<DataRow> list = table.AsEnumerable().ToList();
Enter fullscreen mode Exit fullscreen mode

It’s like neatly stacking your records in separate drawers.

Convert DataTable to List

Converting a DataTable to a List gives us more methods and features for manipulating our data.

var list = table.AsEnumerable().Select(row => new Customer {
  CustomerId = row.Field<int>("CustomerID"),
  CustomerName = row.Field<string>("CustomerName")
}).ToList();
Enter fullscreen mode Exit fullscreen mode

Our DataTable is now a List of Customers.

Creating a DataTable from C# List

Creating a DataTable from a List is like reverse engineering!

DataTable newDt = new DataTable();
newDt.Columns.AddRange(new DataColumn[2] {
                   new DataColumn("CustomerId", typeof(int)),
                   new DataColumn("Name", typeof(string))});

foreach (var item in list)
{
    var row = newDt.NewRow();
    row["CustomerId"] = item.CustomerId;
    row["Name"] = item.Name;
    newDt.Rows.Add(row);
}
Enter fullscreen mode Exit fullscreen mode

Surprise! We’ve turned our Customers List back into a DataTable!

Exporting DataTable into Different Formats

Let’s find out how to export our DataTable into various formats. Imagine you’re a magician, and your DataTable is your magic hat!

DataTable to CSV Conversion

Converting a DataTable to a CSV file is like translating your thoughts into another language.

StringBuilder sb = new StringBuilder();
string[] columnNames = dt.Columns.Cast<DataColumn>().Select(column => column.ColumnName).ToArray();
sb.AppendLine(string.Join(",", columnNames));

foreach (DataRow row in dt.Rows)
{
    string[] fields = row.ItemArray.Select(field => field.ToString()).ToArray();
    sb.AppendLine(string.Join(",", fields));
}

File.WriteAllText("path_to_your_csv_file.csv", sb.ToString());
Enter fullscreen mode Exit fullscreen mode

Your data can now speak CSV!

How to Export C# DataTable to Excel

Exporting DataTable to Excel can be easily achieved using libraries such as EPPlus or NPOI.

using (var excelFile = new ExcelPackage())
{
  var worksheet = excelFile.Workbook.Worksheets.Add("Sheet1");
  worksheet.Cells["A1"].LoadFromDataTable(table, true);
  excelFile.SaveAs(new FileInfo("path_to_excel_file.xlsx"));
}
Enter fullscreen mode Exit fullscreen mode

Hocus pocus, our DataTable is now in Excel!

C# DataTable to PDF

The conversion of DataTable to PDF requires third-party libraries like iTextSharp or SelectPdf.

Document document = new Document();
PdfWriter writer = PdfWriter.GetInstance(document, new FileStream("data.pdf", FileMode.Create));
document.Open();
PdfPTable pdfTable = new PdfPTable(dt.Columns.Count);
for (int i = 0; i < dt.Columns.Count; i++) {
  pdfTable.AddCell(new Phrase(dt.Columns[i].ColumnName));
}
for (int i = 0; i < dt.Rows.Count; i++) {
  for (int j = 0; j < dt.Columns.Count; j++) {
    pdfTable.AddCell(new Phrase(dt.Rows[i][j].ToString()));
  }
}
document.Add(pdfTable);
document.Close();
Enter fullscreen mode Exit fullscreen mode

Abracadabra! Our DataTable is now a PDF!

DataReader to DataTable Conversion

Converting a data reader to a DataTable comes handy when we need to manipulate object data using DataTables.

C#: From DataReader to DataTable with Minimum Effort

A DataReader provides a forward-only cursor for reading rows from a SQL Server database, DataTable makes the data manipulation easier.

SqlDataReader reader = command.ExecuteReader();
DataTable dt = new DataTable();
dt.Load(reader);
Enter fullscreen mode Exit fullscreen mode

Boom! We just turned a DataReader into a DataTable!

Using AsEnumerable and Select with DataTable

DataTable’s AsEnumerable extension method provides a powerful way to query data using LINQ, similar to querying a collection of entities.

DataTable AsEnumerable Select

Let’s understand how AsEnumerable and Select all tie up.

var result = from row in table.AsEnumerable()
  where row.Field<int>("CustomerID") == 1
  select row;
Enter fullscreen mode Exit fullscreen mode

No more messing around, eh? We’ve just selected all rows where CustomerID equals 1!

In a nutshell, DataTable allows you to organize and manipulate data in a tabular format, be it creating DataTable, adding rows, fetching column values, sorting, selecting or even exporting to various formats like CSV, Excel, or PDF. I hope that this thorough guide to DataTable in C# has advanced your skills in C#. Don’t forget, practice makes perfect. Happy coding!

💖 💪 🙅 🚩
bytehide
ByteHide

Posted on June 18, 2024

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related