Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

BindingList<T>.AddNew, méthode

Ajoute un nouvel élément à la collection.

Espace de noms :  System.ComponentModel
Assembly :  System (dans System.dll)

public T AddNew()

Valeur de retour

Type : T
Élément ajouté à la liste.

ExceptionCondition
InvalidOperationException

La propriété AllowNew a pour valeur false.

ou

Aucun constructeur public par défaut n'a pu être trouvé pour le type d'élément actuel.

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

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

    Cet événement peut être géré par programme pour construire un nouvel élément personnalisé. Cette action est effectuée dans le gestionnaire d'événements en affectant la valeur du nouvel élément à la propriété NewObject du paramètre AddingNewEventArgs.

    Sinon, le nouvel élément est automatiquement créé via son constructeur public par défaut.

  2. 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 validé explicitement par un appel à EndNew.

    • L'élément est validé implicitement 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, si vous appelez la méthode CancelNew avant que l'élément ne soit validé, ce dernier sera ignoré.

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

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


// 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";
    }
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft