BindingList.AddingNew イベント

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

BindingList.AddingNew イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

項目がリストに追加される前に発生します。

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

Visual Basic (宣言)

Public Event AddingNew As
 AddingNewEventHandler

Visual Basic (使用法)

Dim instance As BindingList(Of
 T)
Dim handler As AddingNewEventHandler

AddHandler instance.AddingNew, handler

C#

public event AddingNewEventHandler AddingNew

C++

public:
event AddingNewEventHandler^ AddingNew {
    void add (AddingNewEventHandler^ value);
    void remove (AddingNewEventHandler^ value);
}

J#

/** @event */
public void add_AddingNew (AddingNewEventHandler
 value)

/** @event */
public void remove_AddingNew (AddingNewEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

AddingNew イベントは、Items プロパティで表されるコレクションに新しいオブジェクトが追加される前に発生します。このイベントは、AddNew メソッドが呼び出された後、新しい項目が作成されて内部リストに追加される前に発生します。このイベントを処理することにより、BindingList からクラスを派生せずに、項目を作成および挿入するためのカスタムの動作をプログラム上で定義できます。

新しい項目のカスタムの機能を定義する方法の詳細については、AddNew メソッドのトピックを参照してください。イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

AddingNew イベントを処理する方法を次のコード例に示します。詳細については、BindingList クラスの概要のトピックを参照してください。

Visual Basic

' Create a new part from the text in the two text boxes.
Private Sub listOfParts_AddingNew(ByVal
 sender As Object, _
    ByVal e As AddingNewEventArgs) Handles
 listOfParts.AddingNew
    e.NewObject = New Part(textBox1.Text, Integer.Parse(textBox2.Text))

End Sub

C#

// Create a new part from the text in the two text boxes.
void listOfParts_AddingNew(object sender, AddingNewEventArgs e)
{
    e.NewObject = new Part(textBox1.Text, int.Parse(textBox2.Text));
    
}

プラットフォーム

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

参照

関連項目
BindingList ジェネリック クラス
BindingList メンバ
System.ComponentModel 名前空間
Items
AddNew
ListChanged