officefileapi-devexpress-dot-spreadsheet-dot-workbook-67474a47.md
Returns the collection of worksheets in a workbook.
You need a license for the DevExpress Office File API Subscription or DevExpress Universal Subscription to use this property in production code.
Namespace : DevExpress.Spreadsheet
Assembly : DevExpress.Docs.v25.2.dll
NuGet Package : DevExpress.Document.Processor
public WorksheetCollection Worksheets { get; }
Public ReadOnly Property Worksheets As WorksheetCollection
| Type | Description |
|---|---|
| WorksheetCollection |
The collection of Worksheet objects.
|
Use the WorksheetCollection object’s members to access, add, and remove worksheets.
Use the WorksheetCollection.Item property to access a worksheet in a workbook.
using DevExpress.Spreadsheet;
// ...
Workbook workbook = new Workbook();
// Access the worksheet collection.
WorksheetCollection worksheets = workbook.Worksheets;
// Access the first worksheet.
Worksheet worksheet1 = workbook.Worksheets[0];
Imports DevExpress.Spreadsheet
' ...
Dim workbook As New Workbook()
' Access the worksheet collection.
Dim worksheets As WorksheetCollection = workbook.Worksheets
' Access the first worksheet.
Dim worksheet1 As Worksheet = workbook.Worksheets(0)
A worksheet index is zero-based. It specifies the worksheet position within a collection.
using DevExpress.Spreadsheet;
// ...
Workbook workbook = new Workbook();
// Access the worksheet collection.
WorksheetCollection worksheets = workbook.Worksheets;
// Access the worksheet with the specified name.
Worksheet worksheet2 = workbook.Worksheets["MainSheet"];
Imports DevExpress.Spreadsheet
' ...
Dim workbook As New Workbook()
' Access the worksheet collection.
Dim worksheets As WorksheetCollection = workbook.Worksheets
' Access the worksheet with the specified name.
Dim worksheet2 As Worksheet = workbook.Worksheets("MainSheet")
A worksheet name is unique within the collection and is shown on a worksheet tab.
Use the WorksheetCollection.ActiveWorksheet property to specify the active worksheet in a workbook.
using DevExpress.Spreadsheet;
// ...
// Set "Sheet2" as the active worksheet.
workbook.Worksheets.ActiveWorksheet = workbook.Worksheets["Sheet2"];
Imports DevExpress.Spreadsheet
' ...
' Set "Sheet2" as the active worksheet.
workbook.Worksheets.ActiveWorksheet = workbook.Worksheets("Sheet2")
Use the WorksheetCollection.Add method to add a worksheet to the end of the worksheet collection.
using DevExpress.Spreadsheet;
// ...
// Add a worksheet with the default name.
// Default names are "Sheet1", "Sheet2", ..., "SheetN".
workbook.Worksheets.Add();
// Add new worksheets with the specified names.
workbook.Worksheets.Add().Name = "TestSheet1";
workbook.Worksheets.Add("TestSheet2");
Imports DevExpress.Spreadsheet
' ...
' Add a worksheet with the default name.
' Default names are "Sheet1", "Sheet2", ..., "SheetN".
workbook.Worksheets.Add()
' Add new worksheets with the specified names.
workbook.Worksheets.Add().Name = "TestSheet1"
workbook.Worksheets.Add("TestSheet2")
The WorksheetCollection.Insert method allows you to insert a worksheet at the specified position in the collection.
using DevExpress.Spreadsheet;
// ...
// Insert a worksheet at the second position in the workbook.
workbook.Worksheets.Insert(1, "TestSheet3");
// Insert a worksheet with the default name at the fourth position in the workbook.
workbook.Worksheets.Insert(3);
Imports DevExpress.Spreadsheet
' ...
' Insert a worksheet at the second position in the workbook.
workbook.Worksheets.Insert(1, "TestSheet3")
' Insert a worksheet with the default name at the fourth position in the workbook.
workbook.Worksheets.Insert(3)
Use the following methods to delete a worksheet:
WorksheetCollection.Remove - removes a specific worksheet from the collection.
WorksheetCollection.RemoveAt - removes the worksheet with the specified index from the collection.
Note
A workbook must contain at least one visible worksheet.
using DevExpress.Spreadsheet;
// ...
// Delete the first worksheet from the workbook.
workbook.Worksheets.RemoveAt(0);
// Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets["Sheet2"]);
Imports DevExpress.Spreadsheet
' ...
' Delete the first worksheet from the workbook.
workbook.Worksheets.RemoveAt(0)
' Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets("Sheet2"))
The following code snippets (auto-collected from DevExpress Examples) contain references to the Worksheets property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.
#region #ProtectChart
Worksheet worksheet = workbook.Worksheets["chartTask3"];
workbook.Worksheets.ActiveWorksheet = worksheet;
#region #ExportToHTML
Worksheet worksheet = workbook.Worksheets["Grouping"];
workbook.Worksheets.ActiveWorksheet = worksheet;
static void InsertRowsColumns(Workbook workbook) {
Worksheet worksheet = workbook.Worksheets[0];
spreadsheet-document-api-import-data-from-data-sources/CS/DataImportExample/Form1.cs#L25
{
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Clear(worksheet.GetUsedRange());
spreadsheet-document-api-data-binding/CS/SpreadsheetApiDataBinding/Program.cs#L14
// Bind a first worksheet to a BindingList
BindWeatherReportToRange(MyWeatherReportSource.DataAsBindingList, workbook.Worksheets[0]);
#Region "#HideLegend"
Dim worksheet As Worksheet = workbook.Worksheets("chartTask3")
workbook.Worksheets.ActiveWorksheet = worksheet
' #Region "#ExportToHTML"
Dim worksheet As Worksheet = workbook.Worksheets("Grouping")
workbook.Worksheets.ActiveWorksheet = worksheet
Private Sub InsertRowsColumns(ByVal workbook As Workbook)
Dim worksheet As Worksheet = workbook.Worksheets(0)
' Populate cells with data.
spreadsheet-document-api-import-data-from-data-sources/VB/DataImportExample/Form1.vb#L19
Try
Dim worksheet As Worksheet = workbook.Worksheets(0)
worksheet.Clear(worksheet.GetUsedRange())
spreadsheet-document-api-data-binding/VB/SpreadsheetApiDataBinding/Program.vb#L13
' Bind a first worksheet to a BindingList
BindWeatherReportToRange(MyWeatherReportSource.DataAsBindingList, workbook.Worksheets(0))
See Also