Back to Devexpress

WorksheetCollection.Remove(Worksheet) Method

officefileapi-devexpress-dot-spreadsheet-dot-worksheetcollection-dot-remove-x28-devexpress-dot-spreadsheet-dot-worksheet-x29.md

latest7.1 KB
Original Source

WorksheetCollection.Remove(Worksheet) Method

Removes the specified worksheet from the collection.

Namespace : DevExpress.Spreadsheet

Assembly : DevExpress.Spreadsheet.v25.2.Core.dll

NuGet Package : DevExpress.Spreadsheet.Core

Declaration

csharp
void Remove(
    Worksheet worksheet
)
vb
Sub Remove(
    worksheet As Worksheet
)

Parameters

NameTypeDescription
worksheetWorksheet

A Worksheet object specifying a worksheet to be removed from a workbook.

|

Remarks

The Remove method disposes of an element removed from the collection. To remove a worksheet by its index in the collection, use the WorksheetCollection.RemoveAt method. You can also hide worksheets (see the How to: Show and Hide a Worksheet topic for details).

Note

A workbook must always contain at least one visible worksheet.

To add new worksheets to a workbook, use the WorksheetCollection.Add or WorksheetCollection.Insert method.

Example

This example demonstrates how to remove a worksheet from a workbook by calling the WorksheetCollection.Remove or WorksheetCollection.RemoveAt method of the WorksheetCollection object that is accessed via the Workbook.Worksheets property.

View Example

csharp
// Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets["Sheet2"]);

// Delete the first worksheet from the workbook.
workbook.Worksheets.RemoveAt(0);
vb
' Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets("Sheet2"))

' Delete the first worksheet from the workbook.
workbook.Worksheets.RemoveAt(0)

The following code snippets (auto-collected from DevExpress Examples) contain references to the Remove(Worksheet) method.

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.

winforms-spreadsheetcontrol-api-part1/CS/SpreadsheetControl/SpreadsheetActions/WorksheetActions.cs#L56

csharp
// Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets["Sheet2"]);

wpf-spreadsheetcontrol-api-part-1/CS/SpreadsheetControl_WPF_API/SpreadsheetActions/WorksheetActions.cs#L67

csharp
// Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets["Sheet2"]);

spreadsheet-document-api-examples-part1/CS/SpreadsheetExamples/SpreadsheetActions/WorksheetActions.cs#L54

csharp
// Delete the "Sheet2" worksheet.
workbook.Worksheets.Remove(workbook.Worksheets["Sheet2"]);

winforms-spreadsheetcontrol-api-part1/VB/SpreadsheetControl/SpreadsheetActions/WorksheetActions.vb#L59

vb
' Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets("Sheet2"))

wpf-spreadsheetcontrol-api-part-1/VB/SpreadsheetControl_WPF_API/SpreadsheetActions/WorksheetActions.vb#L63

vb
' Delete the "Sheet2" worksheet from the workbook.
workbook.Worksheets.Remove(workbook.Worksheets("Sheet2"))

spreadsheet-document-api-examples-part1/VB/SpreadsheetExamples/SpreadsheetActions/WorksheetActions.vb#L60

vb
' Delete the "Sheet2" worksheet.
workbook.Worksheets.Remove(workbook.Worksheets("Sheet2"))
' Delete the first worksheet.

See Also

RemoveAt(Int32)

How to: Access a Worksheet

How to: Add a New Worksheet

How to: Delete a Worksheet

How to: Rename a Worksheet

How to: Move a Worksheet to another Location

How to: Show and Hide a Worksheet

Worksheets in Spreadsheet Documents

WorksheetCollection Interface

WorksheetCollection Members

DevExpress.Spreadsheet Namespace