Add Method (IWorksheets)

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Function Add() As IWorksheet

'Usage
 
Dim instance As IWorksheets
Dim value As IWorksheet
 
value = instance.Add()

IWorksheet Add()

function Add(): IWorksheet;

function Add() : IWorksheet;

IWorksheet* Add();

IWorksheet^ Add();

Return Value

The newly created worksheet.

The new worksheet is created as the last worksheet in the workbook.

C#

class Program
{
    static void Main()
    {
        // Create a new empty workbook set.
        SpreadsheetGear.IWorkbookSet workbookSet = SpreadsheetGear.Factory.GetWorkbookSet();
        // Create a new empty workbook in the workbook set.
        SpreadsheetGear.IWorkbook workbook = workbookSet.Workbooks.Add();
        // Add a second worksheet.
        workbook.Worksheets.Add();
        // Rename worksheet "Sheet1" to "Hello"
        workbook.Worksheets["Sheet1"].Name = "Hello";
        // Rename worksheet "Sheet2" to "World"
        workbook.Worksheets["Sheet2"].Name = "World";
        // Save to C:\MyData.xls.
        workbook.SaveAs("C:\\MyData.xls", SpreadsheetGear.FileFormat.Excel8);
        // Close the workbook, removing it from the workbook set.
        workbookSet.Workbooks.Close();
        // Open the saved workbook from memory.
        workbook = workbookSet.Workbooks.Open("C:\\MyData.xls");
        // Output the sheet names separated by a space ("Hello World").
        System.Console.WriteLine(workbook.Worksheets[0].Name + " " + workbook.Worksheets[1].Name);
    }
}

Visual Basic

Class Program
    Shared Sub Main()
        ' Create a new empty workbook set.
        Dim workbookSet As SpreadsheetGear.IWorkbookSet = SpreadsheetGear.Factory.GetWorkbookSet()
        ' Create a new empty workbook in the workbook set.
        Dim workbook As SpreadsheetGear.IWorkbook = workbookSet.Workbooks.Add()
        ' Add a second worksheet.
        workbook.Worksheets.Add()
        ' Rename worksheet "Sheet1" to "Hello"
        workbook.Worksheets("Sheet1").Name = "Hello"
        ' Rename worksheet "Sheet2" to "World"
        workbook.Worksheets("Sheet2").Name = "World"
        ' Save to C:\MyData.xls.
        workbook.SaveAs("C:\MyData.xls", SpreadsheetGear.FileFormat.Excel8)
        ' Close the workbook, removing it from the workbook set.
        workbookSet.Workbooks.Close()
        ' Open the saved workbook from memory.
        workbook = workbookSet.Workbooks.Open("C:\MyData.xls")
        ' Output the sheet names separated by a space ("Hello World").
        System.Console.WriteLine((workbook.Worksheets(0).Name + " " + workbook.Worksheets(1).Name))
    End Sub 'Main
End Class 'Program

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IWorksheets Interface
IWorksheets Members
CopyAfter Method
CopyBefore Method
Delete Method
MoveAfter Method
MoveBefore Method
AddAfter Method
AddBefore Method