BindingSource.AddNew BindingSource.AddNew BindingSource.AddNew BindingSource.AddNew Method

Definición

Agrega un nuevo elemento a la lista subyacente.Adds a new item to the underlying list.

public:
 virtual System::Object ^ AddNew();
public virtual object AddNew ();
abstract member AddNew : unit -> obj
override this.AddNew : unit -> obj
Public Overridable Function AddNew () As Object

Devoluciones

Object creado y agregado a la lista.The Object that was created and added to the list.

Implementaciones

Excepciones

La propiedad AllowNew se establece en false.The AllowNew property is set to false.

o bien-or- No se ha encontrado ningún constructor sin parámetros público para el tipo de elemento actual.A public parameterless constructor could not be found for the current item type.

Ejemplos

En el ejemplo de código siguiente BindingSource se usa un componente para enlazar DataGridView una lista a un control.The following code example uses a BindingSource component to bind a list to a DataGridView control. El AddingNew controlador de eventos agrega nuevos elementos a la lista.New items are added to the list by the AddingNew event handler. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en cómo: Personalizar la adición de elementos con elWindows Forms BindingSource.This code example is part of a larger example provided in How to: Customize Item Addition with the Windows Forms BindingSource.

private:
   
    void OnMainFormLoad(Object^ sender, EventArgs^ e)
    {
        // Add a DemoCustomer to cause a row to be displayed.
        this->customersBindingSource->AddNew();
          
        // Bind the BindingSource to the DataGridView 
        // control's DataSource.
        this->customersDataGridView->DataSource = 
            this->customersBindingSource;
    }
private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Add a DemoCustomer to cause a row to be displayed.
    this.customersBindingSource.AddNew();

    // Bind the BindingSource to the DataGridView 
    // control's DataSource.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}
Private Sub Form1_Load( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs)

    ' Add a DemoCustomer to cause a row to be displayed.
    Me.customersBindingSource.AddNew()

    ' Bind the BindingSource to the DataGridView 
    ' control's DataSource.
    Me.customersDataGridView.DataSource = Me.customersBindingSource

End Sub

Comentarios

El AddNew método agrega un nuevo elemento a la lista subyacente representada List por la propiedad.The AddNew method adds a new item to the underlying list represented by the List property. Este método configura la siguiente serie de acciones:This method sets up the following series of actions:

  1. Se llama automáticamente al métodoparaconfirmarcualquieroperacióndeediciónpendiente.EndEditThe EndEdit method is automatically called to commit any pending edit operations.

  2. El AddingNew evento se genera automáticamente.The AddingNew event is automatically raised. Este evento se puede controlar mediante programación para construir el nuevo elemento.This event can be programmatically handled to construct the new item. Esto se logra en el controlador de eventos estableciendo la NewObject propiedad System.ComponentModel.AddingNewEventArgs del parámetro en el nuevo elemento.This is accomplished in the event handler by setting the NewObject property of the System.ComponentModel.AddingNewEventArgs parameter to the new item. El nuevo objeto creado en el AddingNew evento debe ser del mismo tipo que el tipo contenido en la lista o se producirá una excepción.The new object created in the AddingNew event must be of the same type as the type contained in the list or an exception will occur.

    Si no AddingNew se controla el evento y la lista subyacente IBindingListes, la solicitud se pasa al método de IBindingList.AddNew la lista.If the AddingNew event is not handled, and the underlying list is an IBindingList, then the request is passed to the list's IBindingList.AddNew method. Si la lista subyacente no IBindingListes, el elemento se crea automáticamente a través de su constructor sin parámetros público.If the underlying list is not an IBindingList, the item is automatically created through its public parameterless constructor. En cualquier caso, el nuevo elemento se agrega al final de la lista.In either case, the new item is added to the end of the list.

  3. El nuevo elemento se agrega inmediatamente a la lista interna a menos que el origen de datos IEditableObject implemente la interfaz.The new item is added immediately to the internal list unless the data source implements the IEditableObject interface. En este caso, el nuevo elemento no se confirma hasta que se realiza una ICancelAddNew.EndNew llamada explícita a o hasta que se inicia una nueva operación de lista.In this case, the new item is not committed until an explicit call to ICancelAddNew.EndNew is made or until a new list operation is initiated. Antes de que se confirme, el nuevo elemento se puede revertir llamando CancelEdita, en cuyo caso se descarta el nuevo elemento.Before it is committed, the new item can be rolled back by calling CancelEdit, in which case the new item is discarded.

Este método genera el ListChanged evento.This method raises the ListChanged event.

Se aplica a

Consulte también: