DataGridViewRowCollection.AddCopy(Int32) メソッド

  • リファレンス

定義

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

指定したインデックスの行に基づいて、新しい行を追加します。

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

パラメーター

indexSource
Int32

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

戻り値

Int32

新しい行のインデックス。

例外

ArgumentOutOfRangeException

indexSource が、ゼロ未満か、コレクション内の行数以上の値です。

InvalidOperationException

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

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

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

- または -

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

- または -

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

- または -

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

注釈

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

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

適用対象

こちらもご覧ください