AddingNewEventArgs 類別

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

來源:

AddingNewEventArgs.cs

提供 AddingNew 事件的資料。

public ref class AddingNewEventArgs : EventArgs

public class AddingNewEventArgs : EventArgs

type AddingNewEventArgs = class
    inherit EventArgs

Public Class AddingNewEventArgs
Inherits EventArgs

繼承

Object

EventArgs

AddingNewEventArgs

範例

下列程式代碼範例示範如何使用 AddingNewEventArgs 類別來處理 BindingSource.AddingNew 事件。 此程式代碼範例是 How to： Customize Item Addition with Windows Forms the bindingSource 中提供之較大範例的一部分。

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

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

' 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

備註

類別 AddingNewEventArgs 會提供 事件的數據 BindingSource.AddingNew ，這表示專案即將加入集合中。 事件會將 屬性設定NewObject為這個新專案，為程式設計人員提供事件處理程式AddingNewEventHandler內的 選項，以提供新物件。 如果未設定這個屬性，集合通常會使用適當類型的無參數建構函式來建構新專案。 不論是哪一種情況，新項目都會新增至集合。

如果集合也實作 ICancelAddNew 介面，則會暫時新增專案，等候後續的認可或復原。

此事件通常用於數據系結案例中，例如和System.ComponentModel.BindingList<T>類別System.Windows.Forms.BindingSource內。

如需如何處理事件的詳細資訊，請參閱 處理和引發事件。

建構函式

AddingNewEventArgs()	不使用參數來初始化 AddingNewEventArgs 類別的新執行個體。
AddingNewEventArgs(Object)	使用指定的物件當做新項目，初始化 AddingNewEventArgs 類別的新執行個體。

屬性

NewObject

取得或設定要加入至繫結清單的物件。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• AddingNewEventHandler
• AddingNew
• ICancelAddNew