Comparteix a través de


BindingList<T>.AddNew Método

Definición

Agrega un nuevo elemento a la colección.

public:
 T AddNew();
public T AddNew ();
member this.AddNew : unit -> 'T
Public Function AddNew () As T

Devoluciones

T

El elemento agregado a la lista.

Excepciones

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 muestra cómo utilizar el método AddNew. BindingList<T>. Para obtener el ejemplo completo, consulte el tema de información general de la BindingList<T> clase.

// Add the new part unless the part number contains
// spaces. In that case cancel the add.
private void button1_Click(object sender, EventArgs e)
{
    Part newPart = listOfParts.AddNew();

    if (newPart.PartName.Contains(" "))
    {
        MessageBox.Show("Part names cannot contain spaces.");
        listOfParts.CancelNew(listOfParts.IndexOf(newPart));
    }
    else
    {
        textBox2.Text = randomNumber.Next(9999).ToString();
        textBox1.Text = "Enter part name";
    }
}
' Add the new part unless the part number contains
' spaces. In that case cancel the add.
Private Sub button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles button1.Click

    Dim newPart As Part = listOfParts.AddNew()

    If newPart.PartName.Contains(" ") Then
        MessageBox.Show("Part names cannot contain spaces.")
        listOfParts.CancelNew(listOfParts.IndexOf(newPart))
    Else
        textBox2.Text = randomNumber.Next(9999).ToString()
        textBox1.Text = "Enter part name"
    End If

End Sub

Comentarios

El AddNew método agrega un nuevo elemento a la colección representada por la Items propiedad . Para agregar un nuevo elemento, se usa la siguiente lógica:

  1. El AddingNew evento se genera automáticamente.

    Este evento se puede controlar mediante programación para construir un nuevo elemento personalizado. Esto se logra en el controlador de eventos estableciendo la NewObject propiedad del AddingNewEventArgs parámetro en el nuevo elemento.

    De lo contrario, el nuevo elemento se crea automáticamente a través de su constructor público sin parámetros.

  2. Se realiza un seguimiento de la posición del nuevo elemento, pero no se agrega a la lista hasta que se cumpla una de las condiciones siguientes:

    • El elemento se confirma explícitamente mediante una llamada a EndNew.

    • El elemento se confirma implícitamente mediante alguna otra operación que cambió el contenido de la lista, como una inserción o eliminación de un elemento.

Por el contrario, llamar al CancelNew método antes de confirmar el elemento hará que se descarte el nuevo elemento.

Este método genera el ListChanged evento cuando se confirma el nuevo elemento.

Se aplica a

Consulte también