DataGridViewRowCollection.IList.Insert(Int32, Object) メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

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

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
void IList.Insert (int index, object? value);
abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit
Sub Insert (index As Integer, value As Object) Implements IList.Insert

パラメーター

index
Int32

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

value
Object

DataGridViewRowCollection に挿入する DataGridViewRow。

実装

Insert(Int32, Object)

例外

InvalidCastException

value が DataGridViewRow ではありません。

ArgumentOutOfRangeException

index が、ゼロ未満か、コレクションの行数を超えています。

ArgumentNullException

value が nullです。

InvalidOperationException

関連付けられている DataGridView コントロールによって、新しい行の追加を一時的に妨げる次の操作のいずれかが実行されています。

  • コントロール内のすべてのセルを選択します。

  • 選択範囲をクリアします。

- または -

このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。

- または -

DataGridView の DataSource プロパティが null ではありません。

- または -

index はコレクション内の行の数と等しく、また DataGridView の AllowUserToAddRows のプロパティが true に設定されています。

- または -

DataGridView に列がありません。

- または -

value の DataGridView プロパティが null ではありません。

- または -

value の Selected プロパティの値が true です。

- または -

この操作を実行すると、固定されていない行の後に固定されている行が挿入されるか、または固定されている行の前に固定されていない行が挿入されます。

ArgumentException

value のセル数が、コントロール内の列数を超えています。

注釈

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

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

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

適用対象

こちらもご覧ください