BindingList<T>.AddNew Méthode

Définition

Ajoute un nouvel élément à la collection.

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

Retours

T

Élément ajouté à la liste.

Exceptions

La propriété AllowNew a la valeur false.

- ou -

Aucun constructeur public sans paramètre n’a pu être trouvé pour le type d’élément actif.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode AddNew. BindingList<T>. Pour obtenir l’exemple complet, consultez la rubrique Vue d’ensemble de la BindingList<T> classe.

// 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

Remarques

La AddNew méthode ajoute un nouvel élément à la collection représentée par la Items propriété . Pour ajouter un nouvel élément, la logique suivante est utilisée :

  1. L’événement AddingNew est automatiquement déclenché.

    Cet événement peut être géré par programmation pour construire un nouvel élément personnalisé. Pour ce faire, dans le gestionnaire d’événements, définissez la NewObject propriété du AddingNewEventArgs paramètre sur le nouvel élément.

    Sinon, le nouvel élément est automatiquement créé via son constructeur public sans paramètre.

  2. La position du nouvel élément est suivie, mais il n’est pas ajouté à la liste tant que l’une des conditions suivantes n’est pas remplie :

    • L’élément est explicitement commité par un appel à EndNew.

    • L’élément est implicitement commité par une autre opération qui a modifié le contenu de la liste, telle qu’une insertion ou une suppression d’un élément.

En revanche, l’appel de la CancelNew méthode avant la validation de l’élément entraîne l’abandon du nouvel élément.

Cette méthode déclenche l’événement ListChanged lorsque le nouvel élément est commité.

S’applique à

Voir aussi