BindingSource.AddingNew 事件

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

在項目加入基礎清單之前發生。

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;

public event System.ComponentModel.AddingNewEventHandler AddingNew;

member this.AddingNew : System.ComponentModel.AddingNewEventHandler 

Public Custom Event AddingNew As AddingNewEventHandler 

事件類型

AddingNewEventHandler

例外狀況

InvalidOperationException

NewObject 的型別與清單中所包含的型別不同。

範例

下列程式碼範例會使用 BindingSource 元件將清單系結至 DataGridView 控制項。 事件處理常式會將新專案新增至清單 AddingNew 。 此程式碼範例是How to： Customize Item Addition with the Windows Forms 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

備註

在 AddingNew 將新物件加入至 屬性所 List 表示的基礎清單中之前，就會發生此事件。 呼叫 方法之後 AddNew 會引發此事件，但在建立新專案並新增至基礎清單之前。 藉由處理此事件，程式設計人員可以提供自訂專案建立和插入行為，而不需要強制衍生自 BindingSource 類別。 這會在事件處理常式中完成，方法是將 參數的 System.ComponentModel.AddingNewEventArgs 屬性設定 NewObject 為新專案。 在 事件中 AddingNew 建立的新物件必須與清單中所包含的類型相同，否則會發生例外狀況。 系結至 DataView 或 DataTable 時，您無法設定 NewObject 屬性，因為您無法將新的 DataRowView 新增至清單。

如需提供自訂新專案功能的詳細資訊，請參閱 AddNew 方法。 如需處理事件的詳細資訊，請參閱 處理和引發事件。

另請參閱

• AddNew()
• OnAddingNew(AddingNewEventArgs)
• AddingNewEventArgs