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位置にある DataGridViewRowInheritedStyle と同じです。InsertCopy メソッドは、可能な場合は、DataGridViewRowCollection に共有行を追加します共有行を追加できない場合新しい行は非共有となります詳細については、「Windows フォーム DataGridView コントロール拡張するための推奨される手順」を参照してください

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

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



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

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

   

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



DataGridViewRowCollection.InsertCopy メソッドのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

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

©2025 GRAS Group, Inc.RSS