DataGridViewRowCollection.Add メソッド

定義

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

オーバーロード

Add()

新しい行をコレクションに追加します。

Add(Int32)

コレクションに、指定した数の新しい行を追加します。

Add(Object[])

コレクションに新しい行を追加し、指定したオブジェクトをセルに事前設定します。

Add(DataGridViewRow)

指定された DataGridViewRow をコレクションに追加します。

Add()

新しい行をコレクションに追加します。

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

戻り値

新しい行のインデックス。

例外

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

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

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

- または -

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

- または -

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

- または -

DataGridView に列がありません。

- または -

この操作は、固定されていない行の後に固定された行を追加します。

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

注釈

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

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

こちらもご覧ください

適用対象

Add(Int32)

コレクションに、指定した数の新しい行を追加します。

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 に追加する行数。

戻り値

追加された最後の行のインデックス。

例外

count が 1 未満です。

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

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

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

- または -

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

- または -

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

- または -

DataGridView に列がありません。

- または -

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

- または -

この操作は、固定されていない行の後に固定された行を追加します。

注釈

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

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

こちらもご覧ください

適用対象

Add(Object[])

コレクションに新しい行を追加し、指定したオブジェクトをセルに事前設定します。

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 のセルを事前設定する可変数のオブジェクト。

戻り値

新しい行のインデックス。

例外

valuesnullです。

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

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

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

- または -

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

- または -

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

- または -

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

- または -

DataGridView に列がありません。

- または -

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

- または -

この操作は、固定されていない行の後に固定された行を追加します。

注釈

メソッドは Add(Object[]) 、共有されていない行を に追加します DataGridViewRowCollection。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

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

こちらもご覧ください

適用対象

Add(DataGridViewRow)

指定された DataGridViewRow をコレクションに追加します。

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
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

パラメーター

dataGridViewRow
DataGridViewRow

DataGridViewRow に追加する DataGridViewRowCollection

戻り値

新しい DataGridViewRow のインデックス。

例外

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

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

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

- または -

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

- または -

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

- または -

DataGridView に列がありません。

- または -

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

- または -

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

- または -

この操作は、固定されていない行の後に固定された行を追加します。

dataGridViewRownullです。

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

注釈

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

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

こちらもご覧ください

適用対象