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

  • リファレンス

定義

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

指定した行数を、指定したインデックス位置の行に基づくコレクションに追加します。

public:
 virtual int AddCopies(int indexSource, int count);
public virtual int AddCopies (int indexSource, int count);
abstract member AddCopies : int * int -> int
override this.AddCopies : int * int -> int
Public Overridable Function AddCopies (indexSource As Integer, count As Integer) As Integer

パラメーター

indexSource
Int32

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

count
Int32

DataGridViewRowCollection に追加する行数。

戻り値

Int32

追加された最後の行のインデックス。

例外

ArgumentOutOfRangeException

indexSource が、ゼロ未満か、コントロール内の行数以上の値です。

- または -

count が 0 未満です。

InvalidOperationException

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

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

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

- または -

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

- または -

DataGridView の DataSource プロパティが null ではありません。

- または -

この操作は、固定されていない行の後に固定された行を追加します。

注釈

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

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

適用対象

こちらもご覧ください