AddingNewEventArgs Class

Definition

Fornisce i dati per l'evento AddingNew.Provides data for the AddingNew event.

public ref class AddingNewEventArgs : EventArgs
public class AddingNewEventArgs : EventArgs
type AddingNewEventArgs = class
    inherit EventArgs
Public Class AddingNewEventArgs
Inherits EventArgs
Inheritance
AddingNewEventArgs

Examples

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la classe AddingNewEventArgs per gestire l'evento BindingSource.AddingNew.The following code example demonstrates how to use the AddingNewEventArgs class to handle the BindingSource.AddingNew event. Questo esempio di codice fa parte di un esempio più ampio fornito in procedura: personalizzare l'aggiunta di elementi con il Windows Forms BindingSource.This code example is part of a larger example provided 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

Remarks

La classe AddingNewEventArgs fornisce dati per l'evento BindingSource.AddingNew, che segnala che un elemento sta per essere aggiunto a una raccolta.The AddingNewEventArgs class provides data for the BindingSource.AddingNew event, which signals that an item is about to be added to a collection. L'evento assegna al programmatore, all'interno del gestore eventi AddingNewEventHandler, l'opzione di fornire il nuovo oggetto impostando la proprietà NewObject su questo nuovo elemento.The event gives the programmer, within the event handler AddingNewEventHandler, the option of supplying the new object by setting the NewObject property to this new item. Se questa proprietà non è impostata, la raccolta utilizzerà in genere il costruttore senza parametri del tipo appropriato per costruire un nuovo elemento.If this property is not set, the collection will typically use the parameterless constructor of the appropriate type to construct a new item. In entrambi i casi, il nuovo elemento verrà aggiunto alla raccolta.In either case, the new item will be added to the collection.

Se la raccolta implementa anche l'interfaccia ICancelAddNew, l'elemento verrà aggiunto in modalità provvisoria, in attesa di un commit o di un rollback successivo.If the collection also implements the ICancelAddNew interface, the item will be provisionally added, waiting a subsequent commit or rollback.

Questo evento viene comunemente usato negli scenari di associazione dati, all'interno di classi come System.Windows.Forms.BindingSource e System.ComponentModel.BindingList<T>.This event is commonly used in data-binding scenarios, within classes such as System.Windows.Forms.BindingSource and System.ComponentModel.BindingList<T>.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.For more information about how to handle events, see Handling and Raising Events.

Constructors

AddingNewEventArgs()

Inizializza una nuova istanza della classe AddingNewEventArgs senza utilizzare parametri.Initializes a new instance of the AddingNewEventArgs class using no parameters.

AddingNewEventArgs(Object)

Inizializza una nuova istanza della classe AddingNewEventArgs utilizzando l'oggetto specificato come nuovo elemento.Initializes a new instance of the AddingNewEventArgs class using the specified object as the new item.

Properties

NewObject

Ottiene o imposta l'oggetto da aggiungere all'elenco di associazioni.Gets or sets the object to be added to the binding list.

Methods

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also