BindingSource.AddNew Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega un nuevo elemento a la lista subyacente.

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

Object creado y agregado a la lista.

Implementaciones

AddNew()

Excepciones

InvalidOperationException

La propiedad AllowNew se establece en false.

o bien

No se ha encontrado ningún constructor sin parámetros público para el tipo de elemento actual.

Ejemplos

En el ejemplo de código siguiente se usa un BindingSource componente para enlazar una lista a un DataGridView control . El controlador de eventos agrega nuevos elementos a la lista AddingNew . Este ejemplo de código forma parte de un ejemplo más grande proporcionado en 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 por la List propiedad . Este método configura la siguiente serie de acciones:

1. Se EndEdit llama automáticamente al método para confirmar las operaciones de edición pendientes.

2. El AddingNew evento se genera automáticamente. Este evento se puede controlar mediante programación para construir el nuevo elemento. Esto se logra en el controlador de eventos estableciendo la NewObject propiedad del System.ComponentModel.AddingNewEventArgs parámetro en el nuevo elemento. 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.

   Si el AddingNew evento no se controla y la lista subyacente es , IBindingListla solicitud se pasa al método de IBindingList.AddNew la lista. Si la lista subyacente no es un elemento IBindingList, el elemento se crea automáticamente mediante su constructor público predeterminado. En cualquier caso, el nuevo elemento se agrega al final de la lista.

3. El nuevo elemento se agrega inmediatamente a la lista interna a menos que el origen de datos implemente la IEditableObject interfaz . En este caso, el nuevo elemento no se confirma hasta que se realiza una llamada explícita a ICancelAddNew.EndNew o hasta que se inicia una nueva operación de lista. Antes de confirmarlo, el nuevo elemento se puede revertir llamando a CancelEdit, en cuyo caso se descarta el nuevo elemento.

Este método genera el ListChanged evento .

Consulte también

• AddNew()
• AddingNewEventArgs
• AddingNew
• AllowNew
• IBindingList