Click here to Skip to main content
13,006,705 members (58,661 online)
Click here to Skip to main content
Add your own
alternative version


32 bookmarked
Posted 23 Nov 2010

A Handy-Dandy Little Class for Accessing Excel Worksheet Cells

, 1 Dec 2010
Rate this:
Please Sign up or sign in to vote.
A class that accepts a reference to an Excel.Worksheet and lets you use an overloaded subscript operator to cleanly and intuitively read/write the Value2 of Excel cells, and get the Excel.Range corresponding to a given cell.


Sometimes, when you're using the Excel.Interop classes, you want to open a worksheet from code and tweak the values of various cells. It's hard to remember the syntax.

oSheet = (Excel.Worksheet)oBook.Worksheets[1];
((Excel.Range)oSheet.Cells[1, 1]).Value2 = "blah";

I don't know about you, but I might like to encapsulate the Excel.Worksheet object I am using in a nice class with perhaps an operator [] overload, so I don't have to remember crazy syntax all the day long or be looking up code snippets and copying and pasting. I'm thinking that code of the form:

cellObj[1, 1]="blah";
int myCellValue = Convert.ToInt32(cellObj[1,2]);

is perhaps a bit more readable. So let's see if we can't make a class to help us with this.

ExcelCell Class

First, let's dive right into the meat. Here's the definition of our class, ExcelCell, which encapsulates the Excel.Worksheet object from Excel and allows access to individual cells.

using Office = Microsoft.Office.Core;
using Excel = Microsoft.Office.Interop.Excel;
public class ExcelCell : Object
    private Excel.Worksheet oSheet;
    public ExcelCell(Excel.Worksheet oSheet)
        this.oSheet = oSheet;
    public object this[int row, int column]
            if (oSheet == null)
                throw new InvalidOperationException(
                "Excel.Worksheet reference is null.");
            return ((Excel.Range)oSheet.Cells[row, column]).Value2;
            if (oSheet == null)
            throw new InvalidOperationException(
                "Excel.Worksheet reference is null.");
            ((Excel.Range)oSheet.Cells[row, column]).Value2 = value;
    public Excel.Range GetRange(int row, int column)
        if (oSheet == null)
            throw new InvalidOperationException(
        "Excel.Worksheet reference is null.");
        return ((Excel.Range)oSheet.Cells[row, column]);

Note: You should make sure that you have the Microsoft.Office.Core and Microsoft.Office.Interop.Excel modules loaded as references in your project. They can be version 12 and up.

Using the Class

To use the class, say you have an instance of Excel.Application open and an instance of Excel.Workbook open as well (in .xls or .xlsx etc. format), and your instances are named oExcel and oBook, respectively. Let's see this class in action:

ExcelCell cell = new ExcelCell((Excel.Worksheet)oBook.Worksheets[1]);
cell[4, 2] = "happy";
cell[4, 4] = "day"; // sets Value2

int cellValue = Convert.ToInt32(cell[4,5]);
// reading a cell -- very straightforward.

And that's all she wrote!

Points of Interest

This class is interesting in that it reveals how to overload the [,] operator. A quick Google search can also find you the information, but watch how simplified your Excel programming gets after putting this class in your program.


  • 23 Nov. 2010: Article submitted.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Brian C Hart
Software Developer (Senior) Corrugated Technologies, Inc.
United States United States
From Fridley, Minnesota and I like computer programming! When I got started, I was working mostly with Windows GUI programming in C/C++. Then later on I worked with COM/DCOM for a school internship. I used COM/DCOM to write an ad hoc cluster server and job-running environment for a cluster of 24 Windows-based high-end visualization workstations. I moved on to C# and have been working in C# and Windows Forms ever since. I have yet to embrace Silverlight Smile | :)

You may also be interested in...

Comments and Discussions

GeneralMy vote of 1 Pin
Clifford Nelson30-Jul-12 10:03
memberClifford Nelson30-Jul-12 10:03 
GeneralAlternative Excel component Pin
CikaPero28-Mar-11 0:38
memberCikaPero28-Mar-11 0:38 
GeneralThanks - This cleaned up my code considerably. Pin
rajaquila22-Dec-10 4:17
memberrajaquila22-Dec-10 4:17 
GeneralMy vote of 5 Pin
thatraja30-Nov-10 2:45
memberthatraja30-Nov-10 2:45 
GeneralRe: My vote of 5 Pin
Brian C. Hart, Ph.D.1-Dec-10 10:04
memberBrian C. Hart, Ph.D.1-Dec-10 10:04 
GeneralVery cool, but even better if you... Pin
DaveX8629-Nov-10 15:54
memberDaveX8629-Nov-10 15:54 
GeneralMore, more Pin
John Whitmire29-Nov-10 5:05
memberJohn Whitmire29-Nov-10 5:05 
GeneralRe: More, more Pin
Brian C. Hart, Ph.D.29-Nov-10 5:16
memberBrian C. Hart, Ph.D.29-Nov-10 5:16 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170628.1 | Last Updated 1 Dec 2010
Article Copyright 2010 by Brian C Hart
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid