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

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

DataGridViewRowCollection.InsertCopies メソッド

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

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

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

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

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

パラメータ

indexSource

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

indexDestination

行を挿入する位置。

count

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

例外例外
例外の種類条件

ArgumentOutOfRangeException

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

または

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

または

count が 1 未満です。

InvalidOperationException

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

または

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

  • CellEnter

  • CellLeave

  • CellValidating

  • CellValidated

  • RowEnter

  • RowLeave

  • RowValidated

  • RowValidating

または

indexDestination がコレクションに含まれる行数と同じであり、DataGridView.AllowUserToAddRows が true です。

または

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

解説解説

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

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

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



英和和英テキスト翻訳

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

辞書ショートカット

すべての辞書の索引

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

   

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



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

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

©2026 GRAS Group, Inc.RSS