次の方法で共有


DataGridViewRowCollection.Insert メソッド

定義

コレクションに 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

例外

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

dataGridViewRownullです。

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

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

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

- または -

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

- または -

DataGridViewDataSource プロパティが null ではありません。

- または -

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

- または -

DataGridView に列がありません。

- または -

dataGridViewRowDataGridView プロパティが null ではありません。

- または -

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

- または -

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

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

注釈

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

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

こちらもご覧ください

適用対象

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 に挿入する行数。

例外

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

- または -

count が 1 未満です。

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

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

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

- または -

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

- または -

DataGridViewDataSource プロパティが null ではありません。

- または -

DataGridView に列がありません。

- または -

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

- または -

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

- または -

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

注釈

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

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

こちらもご覧ください

適用対象

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[]

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

例外

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

valuesnullです。

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

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

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

- または -

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

- または -

DataGridViewVirtualMode プロパティは true に設定されます。

- または -

DataGridViewDataSource プロパティが null ではありません。

- または -

DataGridView に列がありません。

- または -

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

- または -

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

- または -

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

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

注釈

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

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

こちらもご覧ください

適用対象