Click here to Skip to main content
6,295,667 members and growing! (9,817 online)
Email Password   helpLost your password?
Web Development » ASP.NET » Howto     Intermediate

C# - Retrieve Excel Workbook Sheet Names.

By Kenny Young

This article provides a way to retrieve the worksheet names of an Excel Workbook. This can be used to query a workbook using ADO.NET if you do not know the names of the worksheets.
C#, Windows, .NET, ASP.NET, Visual Studio, Dev
Posted:25 Aug 2004
Views:144,038
Bookmarked:70 times
Announcements
Loading...
 
Search    
Advanced Search
printPrint   Broken Article?Report       add Share
  Discuss Discuss   Recommend Article Email
55 votes for this article.
Popularity: 8.12 Rating: 4.67 out of 5
1 vote, 1.8%
1

2
2 votes, 3.6%
3
5 votes, 9.1%
4
47 votes, 85.5%
5

Introduction

There are many examples using ADO.NET to query an Excel Workbook but they all have a limitation, you must know the worksheet name. This might work if you know the name of the worksheet, but what if you don't? If your program is dynamic and your sheet names differ for each Excel workbook, you need a way to extract the names of the sheets. The code example provides you with a way to retrieve the work sheet names.

The following method returns a string array containing the names of the sheets. The method also shows how to loop through the array. The method has one input parameter excelFile which is the location of the Excel file.

Code Example

/// <summary>

/// This mehtod retrieves the excel sheet names from 

/// an excel workbook.

/// </summary>

/// <param name="excelFile">The excel file.</param>

/// <returns>String[]</returns>

private String[] GetExcelSheetNames(string excelFile)
{
  OleDbConnection objConn = null;
  System.Data.DataTable dt = null;

  try
  {
    // Connection String. Change the excel file to the file you

    // will search.

    String connString = "Provider=Microsoft.Jet.OLEDB.4.0;" + 
        "Data Source=" + excelFile + ";Extended Properties=Excel 8.0;";
    // Create connection object by using the preceding connection string.

    objConn = new OleDbConnection(connString);
    // Open connection with the database.

    objConn.Open();
    // Get the data table containg the schema guid.

    dt = objConn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, null);
 
    if(dt == null)
    {
      return null;
    }

    String[] excelSheets = new String[dt.Rows.Count];
    int i = 0;

    // Add the sheet name to the string array.

    foreach(DataRow row in dt.Rows)
    {
      excelSheets[i] = row["TABLE_NAME"].ToString();
      i++;
    }

    // Loop through all of the sheets if you want too...

    for(int j=0; j < excelSheets.Length; j++)
    {
      // Query each excel sheet.

    }

    return excelSheets;
  }
  catch(Exception ex)
  {
    return null;
  }
  finally
  {
    // Clean up.

    if(objConn != null)
    {
      objConn.Close();
      objConn.Dispose();
    }
    if(dt != null)
    {
      dt.Dispose();
    }
  }
}

Enjoy...

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

Kenny Young


Member
B.S. - University of South Florida.

Ken currently works as a software architect at the Pediatrics Epidemiology Center at the University of South Florida. He is involved in the architecture and design on numerous clinical trial projects at the center. Some of the project include:

1. Rare Diseases Clinical Research Network
2. Florida Neurofibromatosis
3. Cystic Fibrosis
4. AIDA
5. TrialNet
Occupation: Architect
Location: United States United States

Other popular ASP.NET articles:

Article Top
You must Sign In to use this message board.
FAQ FAQ 
 
Noise Tolerance  Layout  Per page   
 Msgs 1 to 25 of 27 (Total in Forum: 27) (Refresh)FirstPrevNext
GeneralGreat! Pinmemberpjvanzyl@yahoo.com3:32 30 Jun '09  
GeneralThanks PinmemberKenneth_Scott7:26 11 Jun '09  
GeneralVery Helpful Pinmemberaccusteve10:10 25 Mar '09  
GeneralVery useful Artical Pinmembersorabh.jain20:43 17 Feb '09  
GeneralOrder of Tabs Pinmembersdb774:52 7 Oct '08  
GeneralHow to get the real names? Without $ or ' Pinmemberfanndibong19:39 6 Apr '08  
GeneralGood article Pinmemberjunique9:48 4 Mar '08  
GeneralRe: Good article Pinmemberronny_29517:47 7 Jan '09  
Generalaccess to excel Pinmemberhamedeng8:37 7 Sep '07  
GeneralC# - Inserting Rows in Excel WorkSheet PinmemberXBenedict23:04 12 Jul '07  
GeneralRe: C# - Inserting Rows in Excel WorkSheet Pinmemberprivacy space23:35 23 Aug '07  
GeneralPassword Protected PinmemberRedDogEdward2:51 5 Dec '06  
GeneralDoesn't seem to work with Excel 5.0 files. Pinmembertolsen6413:37 9 Feb '06  
GeneralAdd Worksheet PinmemberBikash Rai21:25 7 Oct '05  
GeneralGetting retriving excel sheets Pinmembergodfathers23:09 2 Mar '05  
GeneralRe: Getting retriving excel sheets Pinmemberabhi kumar21:05 16 Aug '05  
GeneralA Better Way??? PinsussAnonymous13:32 30 Oct '04  
GeneralRe: A Better Way??? PinmemberMike Ellison14:59 30 Oct '04  
GeneralExcel Sheets PinsussAnonymous10:23 15 Sep '04  
GeneralGood Work Pinmemberterence wallace18:45 30 Aug '04  
Generalgood tip PinmemberAshley van Gerven17:31 26 Aug '04  
GeneralRe: good tip PinmemberLabrat00221:17 26 Aug '04  
GeneralRe: good tip PinmemberAshley van Gerven4:18 30 Aug '04  
GeneralHidden Sheets? PinmemberMike Ellison8:12 26 Aug '04  
GeneralRe: Hidden Sheets? PinmemberKen G Young10:47 30 Aug '04  

General General    News News    Question Question    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

PermaLink | Privacy | Terms of Use
Last Updated: 25 Aug 2004
Editor: Smitha Vijayan
Copyright 2004 by Kenny Young
Everything else Copyright © CodeProject, 1999-2009
Web18 | Advertise on the Code Project