AddingNewEventHandler Delegat

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

Reprezentuje metodę, która będzie obsługiwać AddingNew zdarzenie.

public delegate void AddingNewEventHandler(System::Object ^ sender, AddingNewEventArgs ^ e);

public delegate void AddingNewEventHandler(object? sender, AddingNewEventArgs e);

type AddingNewEventHandler = delegate of obj * AddingNewEventArgs -> unit

Public Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)

Parametry

sender

Object

Źródło zdarzenia, zazwyczaj kontener danych lub kolekcja powiązana z danymi.

e

AddingNewEventArgs

Element AddingNewEventArgs zawierający dane zdarzenia.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać delegata AddingNewEventHandler do obsługi BindingSource.AddingNew zdarzenia. Ten przykładowy kod jest częścią większego przykładu przedstawionego w temacie How to: Customize Item Addition with the Windows Forms BindingSource (Jak dostosować dodawanie elementu za 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

Uwagi

Zdarzenie BindingSource.AddingNew występuje przed dodaniem nowego elementu do kolekcji, zazwyczaj w scenariuszach powiązania danych. Procedura obsługi tego zdarzenia może dostarczyć nowy element do dodania, przesłaniając standardową akcję klasy kolekcji. Jest to realizowane przez ustawienie NewObject właściwości parametru AddingNewEventArgse na ten nowy element. Zazwyczaj ten element musi być typu oczekiwany przez kolekcję adresatów lub kolekcja zgłosi wyjątek typu InvalidCastException.

To zdarzenie jest często używane w scenariuszach powiązania danych w klasach, takich jak System.Windows.Forms.BindingSource i System.ComponentModel.BindingList<T>.

Podczas tworzenia delegata AddingNewEventHandler należy zidentyfikować metodę, która będzie obsługiwać zdarzenie. Aby skojarzyć zdarzenie z programem obsługi zdarzeń, dodaj wystąpienie delegata do zdarzenia. Program obsługi zdarzeń jest wywoływany przy każdym wystąpieniu zdarzenia, o ile nie usunięto delegata. Aby uzyskać więcej informacji na temat delegatów programu obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Metody rozszerzania

GetMethodInfo(Delegate)

Pobiera obiekt reprezentujący metodę reprezentowaną przez określonego delegata.

Zobacz też

• AddingNewEventArgs
• BindingSource
• BindingList<T>