AddingNewEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Daten für das AddingNew-Ereignis bereit.
public ref class AddingNewEventArgs : EventArgspublic class AddingNewEventArgs : EventArgstype AddingNewEventArgs = class
inherit EventArgsPublic Class AddingNewEventArgs
Inherits EventArgs- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die AddingNewEventArgs Klasse zum Behandeln des Ereignisses BindingSource.AddingNew verwendet wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in How to: Customize Item Addition with the Windows Forms BindingSource bereitgestellt wird.
// 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
Hinweise
Die AddingNewEventArgs Klasse stellt Daten für das BindingSource.AddingNew Ereignis bereit, das signalisiert, dass ein Element einer Auflistung hinzugefügt werden soll. Das Ereignis gibt dem Programmierer innerhalb des Ereignishandlers AddingNewEventHandlerdie Option zum Bereitstellen des neuen Objekts, indem die NewObject Eigenschaft auf dieses neue Element festgelegt wird. Wenn diese Eigenschaft nicht festgelegt ist, verwendet die Auflistung in der Regel den parameterlosen Konstruktor des entsprechenden Typs, um ein neues Element zu erstellen. In beiden Fällen wird das neue Element der Auflistung hinzugefügt.
Wenn die Sammlung auch die ICancelAddNew Schnittstelle implementiert, wird das Element vorläufig hinzugefügt und wartet auf einen nachfolgenden Commit oder Rollback.
Dieses Ereignis wird häufig in Datenbindungsszenarien innerhalb von Klassen wie System.Windows.Forms.BindingSource und System.ComponentModel.BindingList<T>.
Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| AddingNewEventArgs() |
Initialisiert eine neue Instanz der AddingNewEventArgs Klasse ohne Parameter. |
| AddingNewEventArgs(Object) |
Initialisiert eine neue Instanz der AddingNewEventArgs Klasse, wobei das angegebene Objekt als neues Element verwendet wird. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| NewObject |
Dient zum Abrufen oder Festlegen des Objekts, das der Bindungsliste hinzugefügt werden soll. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
