DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コレクション内の指定した位置に行を挿入します。
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 -> unitPublic Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)パラメーター
- indexSource
- Int32
新しい行のベースとなる DataGridViewRow のインデックス。
- indexDestination
- Int32
行を挿入する位置。
- count
- Int32
DataGridViewRowCollection に追加する DataGridViewRow オブジェクトの数。
例外
indexSource がゼロ未満であるか、またはコントロール内の行数から 1 を引いた値を超えています。
- または -
indexDestination が、ゼロ未満か、コレクションの行数を超えています。
- または -
count が 1 未満です。
関連付けられている DataGridView コントロールによって、新しい行の追加を一時的に妨げる次の操作のいずれかが実行されています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
- または -
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
- または -
indexDestination がコレクション内の行数と等しく、また AllowUserToAddRows が true です。
- または -
この操作を行うと、固定されていない行の後に固定されている行が挿入されるか、または固定されている行の前に固定されていない行が挿入されます。
注釈
InheritedStyle新しいDataGridViewRowオブジェクトの プロパティは、 に配置された indexSourceの DataGridViewRow と同じ値InheritedStyleを持ちます。 メソッドは InsertCopies 、可能であれば、 に共有行を DataGridViewRowCollection追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
新しい行を追加しても、コントロール内の行は自動的に並べ替えられません。 新しい行を正しい位置に並べ替えるには、イベント ハンドラーで メソッドをDataGridView.RowsAdded呼び出DataGridView.Sortします。 また、イベント ハンドラーで メソッドを DataGridView.Sort 呼び出して、 CellValueChanged ユーザーがセルを変更したときに行を並べ替えることもできます。
適用対象
こちらもご覧ください
.NET