InsertCopy Method

Inserts a row into the collection at the specified position, based on the row at the specified position.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<FeatureAttribute(Name="RowCollection", Version="v5.0")>
Public Overridable Sub InsertCopy( _
   ByVal indexSource As Integer, _
   ByVal indexDestination As Integer _
)

Dim instance As RowCollection
Dim indexSource As Integer
Dim indexDestination As Integer
 
instance.InsertCopy(indexSource, indexDestination)

[Feature(Name="RowCollection", Version="v5.0")]
public virtual void InsertCopy( 
   int indexSource,
   int indexDestination
)

Parameters

indexSource: The index of the row on which to base the new row.
indexDestination: The position at which to insert the row.

Exceptions

Exception	Description
System.InvalidOperationException	This method is accessed when Template is a null reference (Nothing in Visual Basic). -or- The indexDestination is equal to the number of Rows in the collection and the AllowUserToAddRows property of the GcMultiRow control is set to true. -or- The DataSource property of the GcMultiRow control is not a null reference (Nothing in Visual Basic).
System.ArgumentOutOfRangeException	The indexSource is less than 0 or greater than the number of Rows in the collection minus 1. -or- The indexDestination is less than 0 or greater than the number of Rows in the collection.

Exception

Description

System.InvalidOperationException

This method is accessed when Template is a null reference (Nothing in Visual Basic).

-or-

The indexDestination is equal to the number of Rows in the collection and the AllowUserToAddRows property of the GcMultiRow control is set to true.

-or-

The DataSource property of the GcMultiRow control is not a null reference (Nothing in Visual Basic).

System.ArgumentOutOfRangeException

The indexSource is less than 0 or greater than the number of Rows in the collection minus 1.

-or-

The indexDestination is less than 0 or greater than the number of Rows in the collection.

Requirements

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

RowCollection Class
RowCollection Members