AddingNewEventHandler Delegált

Definíció

Névtér:

System.ComponentModel

Szerelvények:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Forrás:

AddingNewEventHandler.cs

Az eseményt kezelő metódust AddingNew jelöli.

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)

Paraméterek

sender

Object

Az esemény forrása, általában egy adattároló vagy adatkötésű gyűjtemény.

e

AddingNewEventArgs

Az AddingNewEventArgs eseményadatokat tartalmazó A.

Példák

Az alábbi példakód bemutatja, hogyan használhatja a meghatalmazottat AddingNewEventHandler az BindingSource.AddingNew esemény kezelésére. Ez a kódpéldát a Az elem hozzáadásának testreszabása a Windows Forms BindingSource című cikkben található nagyobb példa tartalmazza.

// 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

Megjegyzések

Az BindingSource.AddingNew esemény azelőtt történik, hogy új elemet ad hozzá egy gyűjteményhez, általában adatkötési forgatókönyvekben. Az esemény kezelője megadhatja a hozzáadni kívánt új elemet, felülírva a gyűjteményosztály szokásos műveletét. Ez úgy érhető el, hogy a NewObject paraméter AddingNewEventArgs tulajdonságát erre az e új elemre állítja. Általában ennek az elemnek a címzett gyűjtemény által várt típusnak kell lennie, vagy a gyűjtemény kivételt fog kivenni a típusból InvalidCastException.

Ezt az eseményt gyakran használják adatkötési forgatókönyvekben, például System.Windows.Forms.BindingSource és System.ComponentModel.BindingList<T>.

Meghatalmazott létrehozásakor AddingNewEventHandler azonosítja az eseményt kezelő metódust. Az esemény eseménykezelőhöz való társításához adja hozzá a meghatalmazott egy példányát az eseményhez. Az eseménykezelőt mindig meghívja a rendszer, ha nem távolítja el a meghatalmazottat. Az eseménykezelő delegáltjaival kapcsolatos további információkért lásd: Események kezelése és emelése.

Bővítő metódusok

Name	Description
GetMethodInfo(Delegate)	Lekéri a megadott meghatalmazott által képviselt metódust képviselő objektumot.

Lásd még

• AddingNewEventArgs
• BindingSource
• BindingList<T>