DataGridViewRowCollection.InsertCopy メソッドとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > DataGridViewRowCollection.InsertCopy メソッドの意味・解説 

DataGridViewRowCollection.InsertCopy メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

コレクション内の指定した位置に、指定した位置の行を基準に作成された行を追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文構文

Public Overridable Sub InsertCopy
 ( _
    indexSource As Integer, _
    indexDestination As Integer _
)
Dim instance As DataGridViewRowCollection
Dim indexSource As Integer
Dim indexDestination As Integer

instance.InsertCopy(indexSource, indexDestination)
public virtual void InsertCopy (
    int indexSource,
    int indexDestination
)
public:
virtual void InsertCopy (
    int indexSource, 
    int indexDestination
)
public void InsertCopy (
    int indexSource, 
    int indexDestination
)
public function InsertCopy (
    indexSource : int, 
    indexDestination : int
)

パラメータ

indexSource

新しい行の基準となる行のインデックス。

indexDestination

行を挿入する位置。

例外例外
例外の種類条件

ArgumentOutOfRangeException

indexSource が 0 未満か、コレクションの行数 -1 を上回っています。

または

indexDestination が 0 未満か、コレクションに含まれる行数を上回っています。

InvalidOperationException

関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。

または

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

  • CellEnter

  • CellLeave

  • CellValidating

  • CellValidated

  • RowEnter

  • RowLeave

  • RowValidated

  • RowValidating

または

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 メソッドを呼び出すことにより、セルがユーザーによって変更されたときに行を並べ替えることもできます。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
DataGridViewRowCollection クラス
DataGridViewRowCollection メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewRow クラス



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

DataGridViewRowCollection.InsertCopy メソッドのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



DataGridViewRowCollection.InsertCopy メソッドのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS