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 98, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family. SpreadsheetGear for .NET 1.x requires the Microsoft .NET Framework 1.1 or .NET 2.0. SpreadsheetGear for .NET 2006 requires the Microsoft .NET Framework 2.0.

See Also