DataGridViewRowCollection.Insert メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

コレクションに 1 つまたは複数の行を挿入します。

オーバーロード

Insert(Int32, DataGridViewRow)	指定した DataGridViewRow をコレクションに挿入します。
Insert(Int32, Int32)	指定した数の行をコレクション内の指定した場所に挿入します。
Insert(Int32, Object[])	コレクションの指定した位置に行を挿入し、指定したオブジェクトによりセルのデータを設定します。

Insert(Int32, DataGridViewRow)

指定した DataGridViewRow をコレクションに挿入します。

public:
 virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);

public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);

abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit

Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

パラメーター

rowIndex

Int32

行を挿入する位置。

dataGridViewRow

DataGridViewRow

DataGridViewRowCollection に挿入する DataGridViewRow。

例外

ArgumentOutOfRangeException

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

ArgumentNullException

dataGridViewRow が nullです。

InvalidOperationException

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

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

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

- または -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- または -

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

- または -

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

- または -

DataGridView に列がありません。

- または -

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

- または -

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

- または -

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

ArgumentException

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

注釈

メソッドは Insert(Int32, DataGridViewRow) 、可能であれば、 に共有行を DataGridViewRowCollection追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

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

こちらもご覧ください

• DataGridView
• DataGridViewRow

Insert(Int32, Int32)

指定した数の行をコレクション内の指定した場所に挿入します。

public:
 virtual void Insert(int rowIndex, int count);

public virtual void Insert (int rowIndex, int count);

abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit

Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

パラメーター

rowIndex

Int32

行を挿入する位置。

count

Int32

DataGridViewRowCollection に挿入する行数。

例外

ArgumentOutOfRangeException

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

- または -

count が 1 未満です。

InvalidOperationException

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

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

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

- または -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- または -

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

- または -

DataGridView に列がありません。

- または -

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

- または -

RowTemplate プロパティによって返される行に、コントロール内の列より多いセルがあります。

- または -

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

注釈

メソッドは Insert(Int32, Int32) 、 の に RowTemplate 基づく行を追加します DataGridView。 可能であれば、新しい行が共有されます。 最適なスケーラビリティを実現するために、 RowTemplate プロパティで指定された行を共有できることを確認します。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

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

こちらもご覧ください

• DataGridView
• DataGridViewRow

Insert(Int32, Object[])

コレクションの指定した位置に行を挿入し、指定したオブジェクトによりセルのデータを設定します。

public:
 virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);

public virtual void Insert (int rowIndex, params object[] values);

abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit

Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

パラメーター

rowIndex

Int32

行を挿入する位置。

values

Object[]

新しい行のセルのデータを設定する可変数のオブジェクト。

例外

ArgumentOutOfRangeException

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

ArgumentNullException

values が nullです。

InvalidOperationException

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

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

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

- または -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- または -

DataGridView の VirtualMode プロパティは true に設定されます。

- または -

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

- または -

DataGridView に列がありません。

- または -

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

- または -

コントロールの RowTemplate プロパティによって返される行の DataGridView プロパティが null ではありません。

- または -

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

ArgumentException

コントロールの RowTemplate プロパティによって返される行のセル数が、コントロール内の列の数を上回っています。

注釈

メソッドは Insert(Int32, Object[]) 、共有されていない行を に追加します DataGridViewRowCollection。

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

こちらもご覧ください

• DataGridView
• DataGridViewRow