Udostępnij za pośrednictwem

AddingNewEventHandler Delegat

  • Odwołanie

Definicja

Przestrzeń nazw:
System.ComponentModel
Zestaw:
System.ComponentModel.TypeConverter.dll
Zestaw:
System.dll
Zestaw:
netstandard.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);
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ład kodu jest częścią większego przykładu przedstawionego w temacie How to: Customize Item Add with the Windows Forms BindingSource (Dostosowywanie dodawania elementów 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ć typem oczekiwanym 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 należy zidentyfikować metodę AddingNewEventHandler , 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.

Dotyczy

Zobacz też