Insert(Int32) Method

Inserts a new row at the specified location.

Syntax

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

<FeatureAttribute(Name="RowCollection", Version="v5.0")>
Public Overloads Overridable Sub Insert( _
   ByVal rowIndex As Integer _
)

Dim instance As RowCollection
Dim rowIndex As Integer
 
instance.Insert(rowIndex)

[Feature(Name="RowCollection", Version="v5.0")]
public virtual void Insert( 
   int rowIndex
)

Parameters

rowIndex: 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 rowIndex 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 rowIndex 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 rowIndex 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 rowIndex 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
Overload List