DataGridViewRowCollection.InsertCopy メソッド
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

Dim instance As DataGridViewRowCollection Dim indexSource As Integer Dim indexDestination As Integer instance.InsertCopy(indexSource, indexDestination)

例外の種類 | 条件 |
---|---|
ArgumentOutOfRangeException | indexSource が 0 未満か、コレクションの行数 -1 を上回っています。 または |
InvalidOperationException | 関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。 または このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラから呼び出されています。
または indexDestination がコレクションに含まれる行数と同じであり、DataGridView.AllowUserToAddRows が true です。 または この操作を実行すると、固定されていない行の後に固定された行が挿入されるか、または固定された行の前に固定されていない行が挿入されます。 |

このメソッドは、新しい行に indexDestination パラメータで指定されたインデックスを割り当て、以降のすべての行のインデックスを繰り下げます。新しい DataGridViewRow の InheritedStyle プロパティの値は、indexSource の位置にある DataGridViewRow の InheritedStyle と同じです。InsertCopy メソッドは、可能な場合は、DataGridViewRowCollection に共有行を追加します。共有行を追加できない場合、新しい行は非共有となります。詳細については、「Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
新しい行の追加時にコントロール内の行が自動的に並べ替えられることはありません。新しい行を並べ替えた上で正しい位置に挿入するには、DataGridView.RowsAdded イベント ハンドラで System.Windows.Forms.DataGridView.Sort メソッドを呼び出します。また、CellValueChanged イベント ハンドラで System.Windows.Forms.DataGridView.Sort メソッドを呼び出すことにより、セルがユーザーによって変更されたときに行を並べ替えることもできます。

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- DataGridViewRowCollection.InsertCopy メソッドのページへのリンク