DataGridViewRowCollection.IList.Add(Object) メソッド

  • リファレンス

定義

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

DataGridViewRow をコレクションに追加します。

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

パラメーター

value
Object

Object に追加する IList。

戻り値

Int32

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

実装

Add(Object)

例外

InvalidCastException

value が DataGridViewRow ではありません。

InvalidOperationException

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

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

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

- または -

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

- または -

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

- または -

DataGridView に列がありません。

- または -

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

- または -

value の Selected プロパティの値が true です。

- または -

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

ArgumentNullException

value が nullです。

ArgumentException

value のセル数が、コントロール内の列数を超えています。

注釈

このメソッドは、明示的なインターフェイス メンバーの実装です。 これは、DataGridViewRowCollection のインスタンスが IList インターフェイスにキャストされる場合のみ、使用できます。

このメソッドは オーバーロードを Add(DataGridViewRow) 呼び出し、 にキャストした後に value を DataGridViewRow渡します。

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

適用対象

こちらもご覧ください