BindingSource.AddingNew Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

BindingSource.cs

Nastane před přidání položky do podkladového seznamu.

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

public event System.ComponentModel.AddingNewEventHandler? AddingNew;

member this.AddingNew : System.ComponentModel.AddingNewEventHandler 

Public Custom Event AddingNew As AddingNewEventHandler 

Event Type

AddingNewEventHandler

Výjimky

InvalidOperationException

NewObject není stejný typ jako typ obsažený v seznamu.

Příklady

Následující příklad kódu používá komponentu BindingSource k vytvoření vazby seznamu k ovládacímu DataGridView prvku. Do seznamu se přidají nové položky obslužnou rutinou AddingNew události. Tento příklad kódu je součástí většího příkladu uvedeného v části Postupy: Přizpůsobení přidání položky pomocí 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

Poznámky

Událost AddingNew nastane před přidáním nového objektu do podkladového seznamu reprezentované List vlastností. Tato událost se aktivuje po AddNew zavolání metody, ale před vytvořením nové položky a přidáním do podkladového seznamu. Díky zpracování této události může programátor poskytnout vlastní vytvoření položky a chování vložení, aniž by musel odvozovat z BindingSource třídy. To se provádí v obslužné rutině události nastavením NewObject vlastnosti System.ComponentModel.AddingNewEventArgs parametru na novou položku. Nový objekt vytvořený v AddingNew události musí být stejného typu jako typ obsažený v seznamu nebo dojde k výjimce. Vlastnost nelze nastavit NewObject při vazbě k seznamu DataView nebo DataTable proto, že do seznamu nelze přidat novou DataRowView .

Další informace o poskytování vlastních funkcí nové položky naleznete v AddNew metodě. Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.

Viz také

• AddNew()
• OnAddingNew(AddingNewEventArgs)
• AddingNewEventArgs