BindingSource.AddingNew Událost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nastane před přidání položky do podkladového seznamu.
public:
event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
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
Výjimky
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 s ovládacím prvkem DataGridView . Nové položky jsou přidány do seznamu obslužnou rutinou AddingNew události. Tento příklad kódu je součástí většího příkladu uvedeného v tématu Postupy: Přizpůsobení přidávání položek pomocí model 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 zavolání AddNew metody, ale před vytvořením nové položky a přidání do podkladového seznamu. Díky zpracování této události může programátor poskytnout vlastní chování při vytváření a vkládání položek bez vynucení odvození z BindingSource třídy . Toho se dosahuje v obslužné rutině události nastavením NewObject vlastnosti parametru System.ComponentModel.AddingNewEventArgs na novou položku. Nový objekt vytvořený v AddingNew události musí být stejného typu jako typ obsažený v seznamu, jinak dojde k výjimce. Vlastnost nelze nastavitNewObject, pokud je vázána na nebo DataTableDataView, protože do seznamu nelze přidat novýDataRowView.
Další informace o poskytování vlastních funkcí nové položky najdete v AddNew metodě . Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.