AddingNewEventArgs Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Quelle:

AddingNewEventArgs.cs

Stellt Daten für das AddingNew-Ereignis bereit.

public ref class AddingNewEventArgs : EventArgs

public class AddingNewEventArgs : EventArgs

type AddingNewEventArgs = class
    inherit EventArgs

Public Class AddingNewEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

AddingNewEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die AddingNewEventArgs -Klasse verwenden, um das BindingSource.AddingNew Ereignis zu behandeln. Dieses Codebeispiel ist Teil eines größeren Beispiels in How to: Customize Item Addition with the 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

Hinweise

Die AddingNewEventArgs -Klasse stellt Daten für das BindingSource.AddingNew Ereignis bereit, die signalisieren, dass ein Element einer Auflistung hinzugefügt werden soll. Das Ereignis gibt dem Programmierer innerhalb des Ereignishandlers AddingNewEventHandlerdie Möglichkeit, das neue Objekt anzugeben, 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 Auflistung 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 in Klassen wie System.Windows.Forms.BindingSource und System.ComponentModel.BindingList<T>verwendet.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Konstruktoren

AddingNewEventArgs()	Initialisiert eine neue Instanz der AddingNewEventArgs-Klasse ohne Parameter.
AddingNewEventArgs(Object)	Initialisiert eine neue Instanz der AddingNewEventArgs-Klasse unter Verwendung des angegebenen Objekts als neuem Element.

Eigenschaften

NewObject

Ruft das Objekt ab, das der Bindungsliste hinzugefügt werden soll, oder legt dieses fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• AddingNewEventHandler
• AddingNew
• ICancelAddNew