DataGridViewRowCollection.System.Collections.IList.Insert メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewRowCollection.System.Collections.IList.Insert メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

コレクション内の指定したインデックス位置に、DataGridViewRow を挿入します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Private Sub System.Collections.IList.Insert
 ( _
    index As Integer, _
    value As Object _
) Implements IList.Insert

Visual Basic (使用法)

Dim instance As DataGridViewRowCollection
Dim index As Integer
Dim value As Object

CType(instance, IList).Insert(index, value)

C#

void IList.Insert (
    int index,
    Object value
)

C++

private:
virtual void System.Collections.IList.Insert (
    int index, 
    Object^ value
) sealed = IList::Insert

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

index

value を挿入する位置の、0 から始まるインデックス番号。

value

DataGridViewRowCollection に挿入する DataGridViewRow。

例外

例外の種類	条件
InvalidCastException	value が DataGridViewRow ではありません。
ArgumentOutOfRangeException	index が 0 未満か、コレクションに含まれる行数を上回っています。
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。 コントロールのすべてのセルを選択している。 選択範囲をクリアしている。 または このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラから呼び出されています。 CellEnter CellLeave CellValidating CellValidated RowEnter RowLeave RowValidated RowValidating または DataGridView の DataSource プロパティが null 参照 (Visual Basic では Nothing) ではありません。 または index がコレクションに含まれる行数と同じであり、DataGridView の AllowUserToAddRows プロパティが true に設定されています。 または DataGridView に列がありません。 または value の DataGridView プロパティが null 参照 (Visual Basic では Nothing) ではありません。 または value の Selected プロパティ値が true です。 または この操作を実行すると、固定されていない行の後に固定された行が挿入されるか、または固定された行の前に固定されていない行が挿入されます。
ArgumentException	value に、コントロールの列数を超える数のセルが存在します。

解説

このメンバは、明示的なインターフェイス メンバの実装です。DataGridViewRowCollection インスタンスが IList インターフェイスにキャストされた場合にのみ使用できます。

このメソッドは、Insert(Int32,DataGridViewRow) オーバーロードを呼び出し、値を DataGridViewRow にキャストしてから渡します。

新しい行の追加時にコントロール内の行が自動的に並べ替えられることはありません。新しい行を並べ替えた上で正しい位置に挿入するには、DataGridView.RowsAdded イベント ハンドラで System.Windows.Forms.DataGridView.Sort メソッドを呼び出します。また、CellValueChanged イベント ハンドラで System.Windows.Forms.DataGridView.Sort メソッドを呼び出すことにより、セルがユーザーによって変更されたときに行を並べ替えることもできます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewRowCollection クラス
DataGridViewRowCollection メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewRow クラス
IList