BindingSource.AddNew メソッド

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

BindingSource.AddNew メソッド

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

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

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

Visual Basic (宣言)

Public Overridable Function
 AddNew As Object

Visual Basic (使用法)

Dim instance As BindingSource
Dim returnValue As Object

returnValue = instance.AddNew

C#

public virtual Object AddNew ()

C++

public:
virtual Object^ AddNew ()

J#

public Object AddNew ()

JScript

public function AddNew () : Object

戻り値
作成され、リストに追加された Object。

例外

例外の種類	条件
InvalidOperationException	AllowNew プロパティが false に設定されています。 または 現在の項目の型に対応する既定のパブリック コンストラクタがありません。

解説

AddNew メソッドは、List プロパティで表される基底のリストに新しい項目を追加します。このメソッドにより、次に一連の操作が実行されます。

1. EndEdit メソッドが自動的に呼び出され、保留中の編集操作がコミットされます。

2. AddingNew イベントが自動的に発生します。このイベントをプログラム上で処理することにより、新しい項目を作成できます。これは、イベント ハンドラで System.ComponentModel.AddingNewEventArgs パラメータの NewObject プロパティを新しい項目に設定することによって実行できます。AddingNew イベントで作成された新しいオブジェクトは、リストに格納されている型と同じ型であることが必要です。型が異なる場合、例外が発生します。

   AddingNew イベントが処理されず、基底のリストが IBindingList である場合、この要求はリストの IBindingList.AddNew メソッドに渡されます。基底のリストが IBindingList でない場合、パブリックな既定のコンストラクタによって項目が自動的に作成されます。いずれの場合も、新しい項目はリストの最後に追加されます。

3. データ ソースが IEditableObject インターフェイスを実装していない場合、新しい項目は直ちに内部リストに追加されます。このインターフェイスが実装されている場合は、System.ComponentModel.ICancelAddNew.EndNew が明示的に呼び出されるか、新しいリスト操作が初期化されるまで、新しい項目はコミットされません。新しい項目がコミットされるまでに CancelEdit を呼び出すと、新しい項目をロール バックできます。この場合、新しい項目は破棄されます。

このメソッドは、ListChanged イベントを発生させます。

使用例

BindingSource コンポーネントを使用して、リストを DataGridView コントロールにバインドするコード例を次に示します。新しい項目は、AddingNew のイベント ハンドラによってリストに追加されます。次のコード例は、「方法 : Windows フォーム BindingSource を使用した項目の追加をカスタマイズする」で示されている例の一部です。

Visual Basic

' This event handler provides custom item-creation behavior.
 Private Sub customersBindingSource_AddingNew(
 _
 ByVal sender As Object,
 _
 ByVal e As AddingNewEventArgs) _
 Handles customersBindingSource.AddingNew

     e.NewObject = DemoCustomer.CreateNewCustomer()

 End Sub

C#

// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}

C++

// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender, 
    AddingNewEventArgs^ e)
{
    e->NewObject = DemoCustomer::CreateNewCustomer();
}

プラットフォーム

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

参照

関連項目
BindingSource クラス
BindingSource メンバ
System.Windows.Forms 名前空間
AddNew
System.ComponentModel.AddingNewEventArgs
AddingNew
AllowNew
IBindingList