DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

コレクション内の指定した位置に行を挿入します。

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);
public virtual void InsertCopies (int indexSource, int indexDestination, int count);
abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit
Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

パラメーター

indexSource
Int32

新しい行のベースとなる DataGridViewRow のインデックス。

indexDestination
Int32

行を挿入する位置。

count
Int32

DataGridViewRowCollection に追加する DataGridViewRow オブジェクトの数。

例外

ArgumentOutOfRangeException

indexSource がゼロ未満であるか、またはコントロール内の行数から 1 を引いた値を超えています。

- または -

indexDestination が、ゼロ未満か、コレクションの行数を超えています。

- または -

count が 1 未満です。

InvalidOperationException

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

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

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

- または -

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

- または -

indexDestination がコレクション内の行数と等しく、また AllowUserToAddRows が true です。

- または -

この操作を行うと、固定されていない行の後に固定されている行が挿入されるか、または固定されている行の前に固定されていない行が挿入されます。

注釈

InheritedStyle新しいDataGridViewRowオブジェクトの プロパティは、 に配置された indexSourceの DataGridViewRow と同じ値InheritedStyleを持ちます。 メソッドは InsertCopies 、可能であれば、 に共有行を DataGridViewRowCollection追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

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

適用対象

こちらもご覧ください