SpreadsheetGear The Performance Spreadsheet Component Company 
Copy(IRange) Method
See Also  Example
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

C# 
virtual 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: Windows Vista, Windows XP, Windows Server 2008, Windows Server 2003, Windows 2000, Windows Me and Windows 98, including 32 bit and 64 bit editions where applicable. SpreadsheetGear for .NET 1.x requires the Microsoft .NET Framework 1.1 or .NET 2.0 (works with .NET 3.x). SpreadsheetGear for .NET 2007 requires the Microsoft .NET Framework 2.0 (works with .NET 3.x).

See Also