SpreadsheetGear
Copy(IRange) Method
See Also  Example Send Feedback
SpreadsheetGear Namespace > IRange Interface > Copy Method : Copy(IRange) Method

destination
The destination range.
Copies the cells, rows and/or columns of the current IRange to the destination IRange.

Syntax

Visual Basic (Declaration) 
Overloads Sub Copy( _
   ByVal destination As IRange _
)
C# 
void Copy( 
   IRange destination
)

Parameters

destination
The destination range.

Example

C#Copy Code
using System;

 namespace SpreadsheetGear.CopySample
{
   class Program
   {
       static void Main(string[] args)
       {
           // Create a workbook
           SpreadsheetGear.IWorkbook workbook = SpreadsheetGear.Factory.GetWorkbook();
           SpreadsheetGear.IWorksheet worksheet = workbook.Worksheets[0];
           SpreadsheetGear.IRange cells = worksheet.Cells;

           // Put some data in the workbook.
           cells["A2"].Value = "Corn";
           cells["A3"].Value = "Wheat";
           cells["A4"].Value = "Barley";
           cells["B1"].Value = "Jan";
           cells["C1"].Value = "Feb";
           cells["D1"].Value = "Mar";
           cells["B2:D4"].Formula = "=RAND()*10000";

           // Make a copy in the same workbook - the destination will be
           // automatically sized to fit the source.
           cells["A1:D4"].Copy(cells["A6"]);

           // Create a 2nd worksheet.
           SpreadsheetGear.IWorksheet worksheet2 = workbook.Worksheets.Add();

           // Copy from the first worksheet to the 2nd.
           cells["A1:D4"].Copy(worksheet2.Cells["A1"]);

           // Save to disk.
           workbook.SaveAs(@"c:\CopySample.xls", FileFormat.XLS97);
       }
   }
}
    
Visual BasicCopy Code
Imports System
Imports SpreadsheetGear

Namespace SpreadsheetGear.CopySample
    Class Program
        Public Overloads Shared Sub Main()
            ' Create a workbook
            Dim workbook As IWorkbook = Factory.GetWorkbook()
            Dim worksheet As IWorksheet = workbook.Worksheets(0)
            Dim cells As IRange = worksheet.Cells

            ' Put some data in the workbook.
            cells("A2").Value = "Corn"
            cells("A3").Value = "Wheat"
            cells("A4").Value = "Barley"
            cells("B1").Value = "Jan"
            cells("C1").Value = "Feb"
            cells("D1").Value = "Mar"
            cells("B2:D4").Formula = "=RAND()*10000"

            ' Make a copy in the same workbook - the destination will be
            ' automatically sized to fit the source.
            cells("A1:D4").Copy(cells("A6"))

            ' Create a 2nd worksheet.
            Dim worksheet2 As IWorksheet = workbook.Worksheets.Add()

            ' Copy from the first worksheet to the 2nd.
            cells("A1:D4").Copy(worksheet2.Cells("A1"))

            ' Save to disk.
            workbook.SaveAs("c:\CopySample.xls", FileFormat.XLS97)
        End Sub 'Main '
    End Class 'Program
End Namespace 'SpreadsheetGear.CopySample

Remarks

If the current range is not large enough to fill the destination range, the current range is repeated.

Requirements

Platforms: x86 and x64 versions of Windows 2000, Windows XP, Windows Vista, Windows 7, Windows Server 2003 (including R2) and Windows Server 2008 (including R2). SpreadsheetGear 2009 requires the Microsoft .NET Framework 2.0 and supports .NET 3.0 and .NET 3.5.

See Also

Copyright © 2003-2009 SpreadsheetGear LLC. All Rights Reserved.Help Powered by Innovasys   
SpreadsheetGear is a registered trademark of SpreadsheetGear LLC.
Microsoft, Microsoft Excel and Visual Studio are trademarks or registered trademarks of Microsoft Corporation.