DataGridViewRowCollection.Add DataGridViewRowCollection.Add DataGridViewRowCollection.Add DataGridViewRowCollection.Add Method

定義

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

オーバーロード

Add() Add() Add() Add()

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

Add(Int32) Add(Int32) Add(Int32) Add(Int32)

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

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

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

Add(DataGridViewRow) Add(DataGridViewRow) Add(DataGridViewRow)

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

Add() Add() Add() 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- DataGridViewDataSource プロパティが 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) Add(Int32) Add(Int32) 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 Int32 Int32 Int32

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

戻り値

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

例外

関連付けられている 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- DataGridViewDataSource プロパティが 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. 新しい行がに基づいて、RowTemplateDataGridViewします。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[]) Add(Object[]) Add(Object[]) 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.

例外

関連付けられている 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- DataGridViewDataSource プロパティが 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) Add(DataGridViewRow) 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- DataGridViewDataSource プロパティが null ではありません。The DataSource property of the DataGridView is not null.

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

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

- または --or- dataGridViewRowSelected プロパティの値が true です。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.

こちらもご覧ください

適用対象