DataGridViewRowCollection.System.Collections.IList.Add メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewRowCollection.System.Collections.IList.Add メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Private Function System.Collections.IList.Add
 ( _
    value As Object _
) As Integer Implements
 IList.Add

Visual Basic (使用法)

Dim instance As DataGridViewRowCollection
Dim value As Object
Dim returnValue As Integer

returnValue = CType(instance, IList).Add(value)

C#

int IList.Add (
    Object value
)

C++

private:
virtual int System.Collections.IList.Add (
    Object^ value
) sealed = IList::Add

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

value

IList に追加する Object。

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

例外

例外の種類	条件
InvalidCastException	value が DataGridViewRow ではありません。
InvalidOperationException	関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。 コントロールのすべてのセルを選択している。 選択範囲をクリアしている。 または このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラから呼び出されています。 CellEnter CellLeave CellValidating CellValidated RowEnter RowLeave RowValidated RowValidating または DataGridView の DataSource プロパティが null 参照 (Visual Basic では Nothing) ではありません。 または DataGridView に列がありません。 または value の DataGridView プロパティが null 参照 (Visual Basic では Nothing) ではありません。 または value の Selected プロパティ値が true です。 または この操作を実行すると、固定されていない行の後に、固定された行が追加されます。
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。
ArgumentException	value に、コントロールの列数を超える数のセルが存在します。

解説

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

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewRowCollection クラス
DataGridViewRowCollection メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewRow クラス
IList