IBindingList.AddNew メソッド

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

IBindingList.AddNew メソッド

リストに新しい項目を追加します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Function AddNew As Object

Visual Basic (使用法)

Dim instance As IBindingList
Dim returnValue As Object

returnValue = instance.AddNew

C#

Object AddNew ()

C++

Object^ AddNew ()

J#

Object AddNew ()

JScript

function AddNew () : Object

戻り値
リストに追加する項目。

例外

例外の種類	条件
NotSupportedException	AllowNew が false です。

解説

このメソッドは、AllowNew が true の場合にだけサポートされます。それ以外の場合は、NotSupportedException がスローされます。

このメソッドを実装するということは、IBindingList リストに追加されるオブジェクトの型と、その型の新しいインスタンスを作成する方法について、リストが認識していることが必要だということです。たとえば、myCustomer オブジェクトのコレクションがある場合、AddNew メソッドは、新しい myCustomer オブジェクトをリストに追加します。

メモ
このリスト内のオブジェクトが IEditableObject インターフェイスを実装している場合、CancelEdit メソッドを呼び出すと、オブジェクトが AddNew メソッドを使用して作成されている場合は、そのオブジェクトがリストに追加されるのではなく、破棄されます。オブジェクトは、IEditableObject.EndEdit メソッドが呼び出された場合にだけリストに追加されます。したがって、オブジェクトとリストを慎重に同期する必要があります。

このメソッドを呼び出す場合は、適切なインデックスの付いた ItemAdded 列挙体を使用して ListChanged イベントを発生させてください。追加した新しい行は、DataGridView コントロールで Esc キーを押すと削除できる状態にあります。この行で ItemAdded 列挙体を使用して 2 回目に ListChanged イベントを発生させると、その項目が (new 状態ではなく) 通常の行になったことが示されます。

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IBindingList インターフェイス
IBindingList メンバ
System.ComponentModel 名前空間