DataGridViewRowCollection.Add メソッド

定義

1 つ以上の行をコレクションに追加します。Adds one or more rows to the collection.

オーバーロード

Add()

新しい行をコレクションに追加します。Adds a new row to the collection.

Add(Int32)

指定した数の新しい行をコレクションに追加します。Adds the specified number of new rows to the collection.

Add(Object[])

コレクションに新しい行を追加し、指定したオブジェクトをセルに設定します。Adds a new row to the collection, and populates the cells with the specified objects.

Add(DataGridViewRow)

指定された DataGridViewRow をコレクションに追加します。Adds the specified DataGridViewRow to the collection.

Add()

新しい行をコレクションに追加します。Adds a new row to the collection.

public:
 virtual int Add();
public virtual int Add ();
abstract member Add : unit -> int
override this.Add : unit -> int
Public Overridable Function Add () As Integer

戻り値

新しい行のインデックス。The index of the new row.

例外

関連付けられた 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- この操作を実行すると、固定されていない行の後に、固定された行が追加されます。This operation would add a frozen row after unfrozen rows.

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

注釈

オーバーロードAdd()RowTemplateDataGridViewのに基づく行を追加します。The Add() overload 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.

こちらもご覧ください

Add(Int32)

指定した数の新しい行をコレクションに追加します。Adds the specified number of new rows to the collection.

public:
 virtual int Add(int count);
public virtual int Add (int count);
abstract member Add : int -> int
override this.Add : int -> int
Public Overridable Function Add (count As Integer) As Integer

パラメーター

count
Int32

DataGridViewRowCollection に追加する行の数。The number of rows to add to the DataGridViewRowCollection.

戻り値

追加された最後の行のインデックス。The index of the last row that was added.

例外

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

または-or- この操作を実行すると、固定されていない行の後に、固定された行が追加されます。This operation would add frozen rows after unfrozen rows.

注釈

メソッドAdd(Int32)は、 DataGridViewRowCollectionに共有行を追加します。The Add(Int32) method adds shared rows to the DataGridViewRowCollection. 新しい行は、 RowTemplate DataGridViewのに基づいています。The new rows are based on the RowTemplate of the DataGridView. スケーラビリティを最大限に高めるために、 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.

こちらもご覧ください

Add(Object[])

コレクションに新しい行を追加し、指定したオブジェクトをセルに設定します。Adds a new row to the collection, and populates the cells with the specified objects.

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);
public virtual int Add (params object[] values);
abstract member Add : obj[] -> int
override this.Add : obj[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

パラメーター

values
Object[]

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

戻り値

新しい行のインデックス。The index of the new row.

例外

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

- または --or- この操作を実行すると、固定されていない行の後に、固定された行が追加されます。This operation would add a frozen row after unfrozen rows.

注釈

メソッドAdd(Object[])は、共有されてDataGridViewRowCollectionいない行をに追加します。The Add(Object[]) method adds an unshared row to the DataGridViewRowCollection. 詳細については、「 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.

こちらもご覧ください

Add(DataGridViewRow)

指定された DataGridViewRow をコレクションに追加します。Adds the specified DataGridViewRow to the collection.

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int

パラメーター

戻り値

新しい DataGridViewRow のインデックス。The index of the new DataGridViewRow.

例外

関連付けられた 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- DataGridViewdataGridViewRow プロパティが null ではありません。The DataGridView property of the dataGridViewRow is not null.

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

- または --or- この操作を実行すると、固定されていない行の後に、固定された行が追加されます。This operation would add a frozen row after unfrozen rows.

dataGridViewRownullです。dataGridViewRow is null.

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

注釈

メソッドAdd(DataGridViewRow)は、可能DataGridViewRowCollectionであれば、に共有行を追加します。The Add(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.

こちらもご覧ください

適用対象