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

  • リファレンス

定義

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

コレクションの中の指定した位置に、指定した位置の行に基づく行を挿入します。

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

パラメーター

indexSource
Int32

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

indexDestination
Int32

行を挿入する位置。

例外

ArgumentOutOfRangeException

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

- または -

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

InvalidOperationException

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

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

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

- または -

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

- または -

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

- または -

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

注釈

このメソッドは、 パラメーターで指定されたインデックスを新しい行に indexDestination 割り当て、後続のすべての行のインデックスをインクリメントします。 InheritedStyle新しい DataGridViewRow の プロパティは、 にindexSource配置された の DataGridViewRow と同じ値InheritedStyleを持ちます。 メソッドは InsertCopy 、可能であれば、 に共有行を DataGridViewRowCollection追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

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

適用対象

こちらもご覧ください