DataGridViewRowCollection.Insert メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コレクションに 1 つ以上の行を挿入します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Insert(Int32, DataGridViewRow) |
指定した DataGridViewRow をコレクションに挿入します。 |
| Insert(Int32, Int32) |
コレクション内の指定した位置に、指定した数の行を挿入します。 |
| Insert(Int32, Object[]) |
コレクション内の指定した位置に行を挿入し、セルに指定したオブジェクトを設定します。 |
Insert(Int32, DataGridViewRow)
指定した DataGridViewRow をコレクションに挿入します。
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual void Insert(int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)パラメーター
- rowIndex
- Int32
行を挿入する位置。
- dataGridViewRow
- DataGridViewRow
例外
rowIndex が 0 未満か、コレクション内の行数を超えています。
dataGridViewRow は nullです。
関連付けられている DataGridView コントロールは、新しい行の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
DataGridViewの DataSource プロパティはnullされません。
-又は-
rowIndexはコレクション内の行数に等しく、DataGridViewの AllowUserToAddRows プロパティは true に設定されます。
-又は-
DataGridViewには列がありません。
-又は-
dataGridViewRowのDataGridViewプロパティはnullされていません。
-又は-
dataGridViewRowには、trueのSelectedプロパティ値があります。
-又は-
この操作では、固定されていない行の後に固定された行を挿入するか、固定されていない行の前に固定解除行を挿入します。
dataGridViewRow には、コントロール内の列よりも多くのセルがあります。
注釈
Insert(Int32, DataGridViewRow) メソッドは、可能であれば、共有行をDataGridViewRowCollectionに追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールをスケーリングするためのベスト プラクティス」を参照してください。
コントロール内の行は、新しい行が追加されるときに自動的に並べ替えられるわけではありません。 新しい行を適切な位置に並べ替えるには、DataGridView.RowsAdded イベント ハンドラーで DataGridView.Sort メソッドを呼び出します。 また、CellValueChanged イベント ハンドラーで DataGridView.Sort メソッドを呼び出して、ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
Insert(Int32, Int32)
コレクション内の指定した位置に、指定した数の行を挿入します。
public:
virtual void Insert(int rowIndex, int count);public virtual void Insert(int rowIndex, int count);abstract member Insert : int * int -> unit
override this.Insert : int * int -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)パラメーター
- rowIndex
- Int32
行を挿入する位置。
- count
- Int32
DataGridViewRowCollectionに挿入する行の数。
例外
関連付けられている DataGridView コントロールは、新しい行の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
DataGridViewの DataSource プロパティはnullされません。
-又は-
DataGridViewには列がありません。
-又は-
rowIndexはコレクション内の行数に等しく、DataGridViewの AllowUserToAddRows プロパティは true に設定されます。
-又は-
RowTemplate プロパティによって返される行のセル数が、コントロール内の列数を超えています。
-又は-
この操作では、固定されていない行の後に固定された行を挿入するか、固定されていない行の前に固定解除行を挿入します。
注釈
Insert(Int32, Int32) メソッドは、DataGridViewのRowTemplateに基づく行を追加します。 可能であれば、新しい行が共有されます。 スケーラビリティを最大限に高める目的で、 RowTemplate プロパティで指定された行を共有できることを確認してください。 詳細については、「 Windows フォーム DataGridView コントロールをスケーリングするためのベスト プラクティス」を参照してください。
コントロール内の行は、新しい行が追加されるときに自動的に並べ替えられるわけではありません。 新しい行を適切な位置に並べ替えるには、DataGridView.RowsAdded イベント ハンドラーで DataGridView.Sort メソッドを呼び出します。 また、CellValueChanged イベント ハンドラーで DataGridView.Sort メソッドを呼び出して、ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
Insert(Int32, Object[])
コレクション内の指定した位置に行を挿入し、セルに指定したオブジェクトを設定します。
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);public virtual void Insert(int rowIndex, params object[] values);abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())パラメーター
- rowIndex
- Int32
行を挿入する位置。
- values
- Object[]
新しい行のセルを設定する可変数のオブジェクト。
例外
rowIndex が 0 未満か、コレクション内の行数を超えています。
values は nullです。
関連付けられている DataGridView コントロールは、新しい行の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
VirtualMode の DataGridView プロパティは true に設定されます。
-又は-
DataGridViewの DataSource プロパティはnullされません。
-又は-
DataGridViewには列がありません。
-又は-
rowIndexはコレクション内の行数に等しく、DataGridViewの AllowUserToAddRows プロパティは true に設定されます。
-又は-
コントロールの RowTemplate プロパティによって返される行のDataGridView プロパティがnullされていません。
-又は-
この操作では、固定されていない行の後に固定された行を挿入するか、固定されていない行の前に固定解除行を挿入します。
コントロールの RowTemplate プロパティによって返される行には、コントロール内の列よりも多くのセルがあります。
注釈
Insert(Int32, Object[]) メソッドは、共有されていない行をDataGridViewRowCollectionに追加します。
コントロール内の行は、新しい行が追加されるときに自動的に並べ替えられるわけではありません。 新しい行を適切な位置に並べ替えるには、DataGridView.RowsAdded イベント ハンドラーで DataGridView.Sort メソッドを呼び出します。 また、CellValueChanged イベント ハンドラーで DataGridView.Sort メソッドを呼び出して、ユーザーがセルを変更したときに行を並べ替えることもできます。
