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 が、ゼロ未満か、コレクションの行数を超えています。
dataGridViewRow が nullです。
関連付けられている DataGridView コントロールによって、新しい行の追加を一時的に妨げる次の操作のいずれかが実行されています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
- または -
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
- または -
DataGridView の DataSource プロパティが null ではありません。
- または -
rowIndex はコレクション内の行の数と等しく、また DataGridView の AllowUserToAddRows のプロパティが true に設定されています。
- または -
DataGridView に列がありません。
- または -
dataGridViewRow の DataGridView プロパティが null ではありません。
- または -
dataGridViewRow の Selected プロパティの値が true です。
- または -
この操作を実行すると、固定されていない行の後に固定されている行が挿入されるか、または固定されている行の前に固定されていない行が挿入されます。
dataGridViewRow のセル数が、コントロール内の列数を超えています。
注釈
メソッドは Insert(Int32, DataGridViewRow) 、可能であれば、 に共有行を DataGridViewRowCollection追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
新しい行を追加しても、コントロール内の行は自動的に並べ替えられません。 新しい行を正しい位置に並べ替えるには、イベント ハンドラーで メソッドをDataGridView.RowsAdded呼び出DataGridView.Sortします。 また、イベント ハンドラーで メソッドを DataGridView.Sort 呼び出して、 CellValueChanged ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
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) 、 の に RowTemplate 基づく行を追加します DataGridView。 可能であれば、新しい行が共有されます。 最適なスケーラビリティを実現するために、 RowTemplate プロパティで指定された行を共有できることを確認します。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
新しい行を追加しても、コントロール内の行は自動的に並べ替えられません。 新しい行を正しい位置に並べ替えるには、イベント ハンドラーで メソッドをDataGridView.RowsAdded呼び出DataGridView.Sortします。 また、イベント ハンドラーで メソッドを DataGridView.Sort 呼び出して、 CellValueChanged ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
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 が、ゼロ未満か、コレクションの行数を超えています。
values が nullです。
関連付けられている DataGridView コントロールによって、新しい行の追加を一時的に妨げる次の操作のいずれかが実行されています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
- または -
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
- または -
DataGridView の VirtualMode プロパティは true に設定されます。
- または -
DataGridView の DataSource プロパティが null ではありません。
- または -
DataGridView に列がありません。
- または -
rowIndex はコレクション内の行の数と等しく、また DataGridView の AllowUserToAddRows のプロパティが true に設定されています。
- または -
コントロールの RowTemplate プロパティによって返される行の DataGridView プロパティが null ではありません。
- または -
この操作を実行すると、固定されていない行の後に固定されている行が挿入されるか、または固定されている行の前に固定されていない行が挿入されます。
コントロールの RowTemplate プロパティによって返される行のセル数が、コントロール内の列の数を上回っています。
注釈
メソッドは Insert(Int32, Object[]) 、共有されていない行を に追加します DataGridViewRowCollection。
新しい行を追加しても、コントロール内の行は自動的に並べ替えられません。 新しい行を正しい位置に並べ替えるには、イベント ハンドラーで メソッドをDataGridView.RowsAdded呼び出DataGridView.Sortします。 また、イベント ハンドラーで メソッドを DataGridView.Sort 呼び出して、 CellValueChanged ユーザーがセルを変更したときに行を並べ替えることもできます。
こちらもご覧ください
適用対象
.NET