DataGridViewRowCollection.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コレクションに 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 イベントのハンドラーから呼び出されています。
- または -
DataGridView の DataSource プロパティが 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 イベントのハンドラーから呼び出されています。
- または -
DataGridView の DataSource プロパティが null
ではありません。
- または -
DataGridView に列がありません。
- または -
RowTemplate プロパティによって返される行に、コントロール内の列より多いセルがあります。
- または -
この操作は、固定されていない行の後に固定された行を追加します。
注釈
メソッドは Add(Int32) 、 に共有行を追加します DataGridViewRowCollection。 新しい行は、 の DataGridViewにRowTemplate基づいています。 最適なスケーラビリティを実現するために、 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 のセルを事前設定する可変数のオブジェクト。
戻り値
新しい行のインデックス。
例外
values
が null
です。
関連付けられている DataGridView コントロールによって、新しい行の追加を一時的に妨げる次の操作のいずれかが実行されています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
- または -
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
- または -
DataGridView の VirtualMode プロパティは true
に設定されます。
- または -
DataGridView の DataSource プロパティが 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 のインデックス。
例外
関連付けられている DataGridView コントロールによって、新しい行の追加を一時的に妨げる次の操作のいずれかが実行されています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
- または -
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
- または -
DataGridView の DataSource プロパティが null
ではありません。
- または -
DataGridView に列がありません。
- または -
dataGridViewRow
の DataGridView プロパティが null
ではありません。
- または -
dataGridViewRow
の Selected プロパティの値が true
です。
- または -
この操作は、固定されていない行の後に固定された行を追加します。
dataGridViewRow
が null
です。
dataGridViewRow
のセル数が、コントロール内の列数を超えています。
注釈
メソッドは Add(DataGridViewRow) 、可能であれば、 に共有行を DataGridViewRowCollection追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
新しい行を追加しても、コントロール内の行は自動的に並べ替えられません。 新しい行を正しい位置に並べ替えるには、イベント ハンドラーで メソッドをDataGridView.RowsAdded呼び出DataGridView.Sortします。 また、イベント ハンドラーで メソッドを DataGridView.Sort 呼び出して、 CellValueChanged ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Windows フォーム DataGridView コントロールを拡張するための推奨される手順
適用対象
.NET