BindingList<T>.AddNew Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un nouvel élément à la collection.
public:
T AddNew();public T AddNew();member this.AddNew : unit -> 'TPublic Function AddNew () As TRetours
Élément ajouté à la liste.
Exceptions
La AllowNew propriété est définie sur false.
- ou -
Impossible de trouver un constructeur public sans paramètre pour le type d’élément actuel.
Exemples
L’exemple de code suivant montre comment utiliser la AddNew méthode. 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.
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 :
L’événement AddingNew est déclenché automatiquement.
Cet événement peut être géré par programme 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 créé automatiquement via son constructeur sans paramètre public.
La position du nouvel élément est suivie, mais elle n’est pas ajoutée à la liste tant que l’une des conditions suivantes n’est pas remplie :
L’élément est explicitement validé par un appel à EndNew.
L’élément est implicitement validé par une autre opération qui a modifié le contenu de la liste, par exemple 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 validé.
