DataGridViewRowCollection.Insert メソッド

定義

1 つ以上の行をコレクションに挿入します。Inserts one or more rows into the collection.

オーバーロード

Insert(Int32, DataGridViewRow)

指定した DataGridViewRow をコレクションに挿入します。Inserts the specified DataGridViewRow into the collection.

Insert(Int32, Int32)

指定した数の行をコレクション内の指定した位置に挿入します。Inserts the specified number of rows into the collection at the specified location.

Insert(Int32, Object[])

コレクション内の指定した位置に行を挿入し、指定したオブジェクトをセルに設定します。Inserts a row into the collection at the specified position, and populates the cells with the specified objects.

Insert(Int32, DataGridViewRow)

指定した DataGridViewRow をコレクションに挿入します。Inserts the specified DataGridViewRow into the collection.

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

パラメーター

rowIndex
Int32

行を挿入する位置。The position at which to insert the row.

dataGridViewRow
DataGridViewRow

DataGridViewRowCollection に挿入する DataGridViewRowThe DataGridViewRow to insert into the DataGridViewRowCollection.

例外

rowIndex が 0 未満か、コレクションに含まれる行数を上回っています。rowIndex is less than zero or greater than the number of rows in the collection.

dataGridViewRownullです。dataGridViewRow is null.

関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - コントロール内のすべてのセルを選択している。- Selecting all cells in the control.

- 選択範囲をクリアしている。- Clearing the selection.

または-or- このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。This method is being called from a handler for one of the following DataGridView events:

- または --or- DataSourceDataGridView プロパティが null ではありません。The DataSource property of the DataGridView is not null.

または-or- rowIndex はコレクション内の行の数と等しく、また AllowUserToAddRowsDataGridView のプロパティが trueに設定されています。rowIndex is equal to the number of rows in the collection and the AllowUserToAddRows property of the DataGridView is set to true.

または-or- DataGridView に列がありません。The DataGridView has no columns.

- または --or- dataGridViewRowDataGridView プロパティが null ではありません。The DataGridView property of dataGridViewRow is not null.

または-or- dataGridViewRowSelectedtrueプロパティ値があります。dataGridViewRow has a Selected property value of true.

または-or- この操作を実行すると、固定されていない行の後に固定されている行が挿入されるか、または固定されている行の前に固定されていない行が挿入されます。This operation would insert a frozen row after unfrozen rows or an unfrozen row before frozen rows.

dataGridViewRow に、コントロールの列数を超える数のセルが存在します。dataGridViewRow has more cells than there are columns in the control.

注釈

メソッドInsert(Int32, DataGridViewRow)は、可能DataGridViewRowCollectionであれば、に共有行を追加します。The Insert(Int32, DataGridViewRow) method adds a shared row to the DataGridViewRowCollection, if possible. それ以外の場合、新しい行は共有されません。Otherwise, the new row is unshared. 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

新しい行が追加されると、コントロール内の行は自動的に並べ替えられません。Rows in the control are not automatically sorted when new rows are added. 新しい行を正しい位置に並べ替えるには、 DataGridView.Sort DataGridView.RowsAddedイベントハンドラーでメソッドを呼び出します。To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. また、ユーザーがセルを変更DataGridView.SortしたときCellValueChangedに行を並べ替えるために、イベントハンドラーでメソッドを呼び出すこともできます。You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

こちらもご覧ください

Insert(Int32, Int32)

指定した数の行をコレクション内の指定した位置に挿入します。Inserts the specified number of rows into the collection at the specified location.

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

行を挿入する位置。The position at which to insert the rows.

count
Int32

DataGridViewRowCollection に挿入する行の数。The number of rows to insert into the DataGridViewRowCollection.

例外

rowIndex が 0 未満か、コレクションに含まれる行数を上回っています。rowIndex is less than zero or greater than the number of rows in the collection.

- または --or- count が 1 未満です。count is less than 1.

関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - コントロール内のすべてのセルを選択している。- Selecting all cells in the control.

- 選択範囲をクリアしている。- Clearing the selection.

または-or- このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。This method is being called from a handler for one of the following DataGridView events:

または-or- DataSourceDataGridView プロパティが null ではありません。The DataSource property of the DataGridView is not null.

- または --or- DataGridView に列がありません。The DataGridView has no columns.

- または --or- rowIndex はコレクション内の行の数と等しく、また AllowUserToAddRowsDataGridView のプロパティが trueに設定されています。rowIndex is equal to the number of rows in the collection and the AllowUserToAddRows property of the DataGridView is set to true.

- または --or- RowTemplate プロパティによって返された行には、コントロールの列数を超える数のセルが存在します。The row returned by the RowTemplate property has more cells than there are columns in the control.

- または --or- この操作を実行すると、固定されていない行の後に固定された行が挿入されるか、または固定された行の前に固定されていない行が挿入されます。This operation would insert a frozen row after unfrozen rows or an unfrozen row before frozen rows.

注釈

メソッドInsert(Int32, Int32)RowTemplateDataGridViewのに基づく行を追加します。The Insert(Int32, Int32) method adds rows that are based on the RowTemplate of the DataGridView. 可能な場合は、新しい行が共有されます。The new row is shared, if possible. スケーラビリティを最大限に高めるために、 RowTemplateプロパティで指定した行を共有できることを確認してください。Be sure that the row specified in the RowTemplate property can be shared for best scalability. 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

新しい行が追加されると、コントロール内の行は自動的に並べ替えられません。Rows in the control are not automatically sorted when new rows are added. 新しい行を正しい位置に並べ替えるには、 DataGridView.Sort DataGridView.RowsAddedイベントハンドラーでメソッドを呼び出します。To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. また、ユーザーがセルを変更DataGridView.SortしたときCellValueChangedに行を並べ替えるために、イベントハンドラーでメソッドを呼び出すこともできます。You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

こちらもご覧ください

Insert(Int32, Object[])

コレクション内の指定した位置に行を挿入し、指定したオブジェクトをセルに設定します。Inserts a row into the collection at the specified position, and populates the cells with the specified objects.

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

行を挿入する位置。The position at which to insert the row.

values
Object[]

新しい行のセルに設定する可変数のオブジェクト。A variable number of objects that populate the cells of the new row.

例外

rowIndex が 0 未満か、コレクションに含まれる行数を上回っています。rowIndex is less than zero or greater than the number of rows in the collection.

valuesnull です。values is null.

関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - コントロール内のすべてのセルを選択している。- Selecting all cells in the control.

- 選択範囲をクリアしている。- Clearing the selection.

- または --or- このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。This method is being called from a handler for one of the following DataGridView events:

- または --or- VirtualModeDataGridView プロパティが true に設定されています。The VirtualMode property of the DataGridView is set to true.

- または --or- DataSourceDataGridView プロパティが null ではありません。The DataSource property of the DataGridView is not null.

または-or- DataGridView に列がありません。The DataGridView has no columns.

- または --or- rowIndex はコレクション内の行の数と等しく、また AllowUserToAddRowsDataGridView のプロパティが trueに設定されています。rowIndex is equal to the number of rows in the collection and the AllowUserToAddRows property of the DataGridView is set to true.

または-or- コントロールの DataGridView プロパティによって返される行の RowTemplate プロパティが null ではありません。The DataGridView property of the row returned by the control's RowTemplate property is not null.

- または --or- この操作を実行すると、固定されていない行の後に固定された行が挿入されるか、または固定された行の前に固定されていない行が挿入されます。This operation would insert a frozen row after unfrozen rows or an unfrozen row before frozen rows.

コントロールの RowTemplate プロパティによって返された行に、コントロールの列数を超える数のセルが存在します。The row returned by the control's RowTemplate property has more cells than there are columns in the control.

注釈

メソッドInsert(Int32, Object[])は、共有されてDataGridViewRowCollectionいない行をに追加します。The Insert(Int32, Object[]) method adds an unshared row to the DataGridViewRowCollection.

新しい行が追加されると、コントロール内の行は自動的に並べ替えられません。Rows in the control are not automatically sorted when new rows are added. 新しい行を正しい位置に並べ替えるには、 DataGridView.Sort DataGridView.RowsAddedイベントハンドラーでメソッドを呼び出します。To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. また、ユーザーがセルを変更DataGridView.SortしたときCellValueChangedに行を並べ替えるために、イベントハンドラーでメソッドを呼び出すこともできます。You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

こちらもご覧ください

適用対象