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 -> intPublic Overridable Function Add () As Integer戻り値
新しい行のインデックス。
例外
関連付けられている DataGridView コントロールは、新しい行の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
DataGridViewの DataSource プロパティはnullされません。
-又は-
DataGridViewには列がありません。
-又は-
この操作では、固定されていない行の後に固定された行が追加されます。
RowTemplate プロパティによって返される行のセル数が、コントロール内の列数を超えています。
注釈
Add()オーバーロードは、DataGridViewのRowTemplateに基づく行を追加します。 可能であれば、新しい行が共有されます。 スケーラビリティを最大限に高める目的で、 RowTemplate プロパティで指定された行を共有できることを確認してください。 詳細については、「 Windows フォーム DataGridView コントロールをスケーリングするためのベスト プラクティス」を参照してください。
コントロール内の行は、新しい行が追加されるときに自動的に並べ替えられるわけではありません。 新しい行を適切な位置に並べ替えるには、DataGridView.RowsAdded イベント ハンドラーで DataGridView.Sort メソッドを呼び出します。 また、CellValueChanged イベント ハンドラーで DataGridView.Sort メソッドを呼び出して、ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
Add(Int32)
指定した数の新しい行をコレクションに追加します。
public:
virtual int Add(int count);public virtual int Add(int count);abstract member Add : int -> int
override this.Add : int -> intPublic 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 メソッドを呼び出します。 また、CellValueChanged イベント ハンドラーで DataGridView.Sort メソッドを呼び出して、ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
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[] -> intPublic Overridable Function Add (ParamArray values As Object()) As Integerパラメーター
- values
- Object[]
新しい DataGridViewRowのセルを設定するオブジェクトの可変数。
戻り値
新しい行のインデックス。
例外
values は nullです。
関連付けられている DataGridView コントロールは、新しい行の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
VirtualMode の DataGridView プロパティは true に設定されます。
-又は-
DataGridViewの DataSource プロパティはnullされません。
-又は-
DataGridViewには列がありません。
-又は-
RowTemplate プロパティによって返される行のセル数が、コントロール内の列数を超えています。
-又は-
この操作では、固定されていない行の後に固定された行が追加されます。
注釈
Add(Object[]) メソッドは、共有されていない行をDataGridViewRowCollectionに追加します。 詳細については、「 Windows フォーム DataGridView コントロールをスケーリングするためのベスト プラクティス」を参照してください。
コントロール内の行は、新しい行が追加されるときに自動的に並べ替えられるわけではありません。 新しい行を適切な位置に並べ替えるには、DataGridView.RowsAdded イベント ハンドラーで DataGridView.Sort メソッドを呼び出します。 また、CellValueChanged イベント ハンドラーで DataGridView.Sort メソッドを呼び出して、ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
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 -> intPublic Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integerパラメーター
- dataGridViewRow
- DataGridViewRow
戻り値
新しい DataGridViewRowのインデックス。
例外
関連付けられている DataGridView コントロールは、新しい行の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
DataGridViewの DataSource プロパティはnullされません。
-又は-
DataGridViewには列がありません。
-又は-
dataGridViewRowの DataGridView プロパティはnullされません。
-又は-
dataGridViewRowには、trueのSelectedプロパティ値があります。
-又は-
この操作では、固定されていない行の後に固定された行が追加されます。
dataGridViewRow は nullです。
dataGridViewRow には、コントロール内の列よりも多くのセルがあります。
注釈
Add(DataGridViewRow) メソッドは、可能であれば、共有行をDataGridViewRowCollectionに追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールをスケーリングするためのベスト プラクティス」を参照してください。
コントロール内の行は、新しい行が追加されるときに自動的に並べ替えられるわけではありません。 新しい行を適切な位置に並べ替えるには、DataGridView.RowsAdded イベント ハンドラーで DataGridView.Sort メソッドを呼び出します。 また、CellValueChanged イベント ハンドラーで DataGridView.Sort メソッドを呼び出して、ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Windows フォーム DataGridView コントロールのスケーリングに関するベスト プラクティス
