DataGridViewRowCollection.AddCopy(Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したインデックスの行に基づいて、新しい行を追加します。
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
新しい行のベースとなる行のインデックス。
戻り値
新しい行のインデックス。
例外
indexSource
が、ゼロ未満か、コレクション内の行数以上の値です。
関連付けられている DataGridView コントロールによって、新しい行の追加を一時的に妨げる次の操作のいずれかが実行されています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
- または -
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
- または -
DataGridView の DataSource プロパティが null
ではありません。
- または -
この操作は、固定されていない行の後に固定された行を追加します。
注釈
InheritedStyle新しい行の プロパティは、 に配置されたindexSource
行の と同じ値InheritedStyleを持ちます。 メソッドは AddCopy 、可能であれば、 に共有行を DataGridViewRowCollection追加します。 それ以外の場合、新しい行は共有解除されます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
新しい行を追加しても、コントロール内の行は自動的に並べ替えられません。 新しい行を正しい位置に並べ替えるには、イベント ハンドラーで メソッドをDataGridView.RowsAdded呼び出DataGridView.Sortします。 また、イベント ハンドラーで メソッドを DataGridView.Sort 呼び出して、 CellValueChanged ユーザーがセルを変更したときに行を並べ替えることもできます。
適用対象
こちらもご覧ください
.NET