Freigeben über


BindingList<T>.AddNew Methode

Definition

Fügt der Auflistung ein neues Element hinzu.

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

Gibt zurück

T

Das der Liste hinzugefügte Element.

Ausnahmen

Die AllowNew-Eigenschaft ist auf false festgelegt.

- oder -

Für den aktuellen Elementtyp konnte kein öffentlicher parameterloser Konstruktor gefunden werden.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die AddNew-Methode verwenden. BindingList<T>. Das vollständige Beispiel finden Sie im BindingList<T> Thema klassenübersicht.

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

Hinweise

Die AddNew -Methode fügt der durch die Items -Eigenschaft dargestellten Auflistung ein neues Element hinzu. Um ein neues Element hinzuzufügen, wird die folgende Logik verwendet:

  1. Das AddingNew Ereignis wird automatisch ausgelöst.

    Dieses Ereignis kann programmgesteuert behandelt werden, um ein neues benutzerdefiniertes Element zu erstellen. Dies wird im Ereignishandler erreicht, indem die NewObject -Eigenschaft des AddingNewEventArgs Parameters auf das neue Element festgelegt wird.

    Andernfalls wird das neue Element automatisch über seinen öffentlichen parameterlosen Konstruktor erstellt.

  2. Die Position des neuen Elements wird nachverfolgt, aber es wird der Liste erst hinzugefügt, wenn eine der folgenden Bedingungen erfüllt ist:

    • Das Element wird explizit durch einen Aufruf von committet EndNew.

    • Das Element wird implizit von einem anderen Vorgang committet, der den Inhalt der Liste geändert hat, z. B. das Einfügen oder Entfernen eines Elements.

Im Gegensatz dazu führt das Aufrufen der CancelNew -Methode vor dem Commit des Elements dazu, dass das neue Element verworfen wird.

Diese Methode löst das ListChanged -Ereignis aus, wenn ein Commit für das neue Element ausgeführt wird.

Gilt für:

Weitere Informationen