BindingList<T>.AddNew Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Auflistung ein neues Element hinzu.
public:
T AddNew();public T AddNew();member this.AddNew : unit -> 'TPublic Function AddNew () As TGibt zurück
Das Element, das der Liste hinzugefügt wurde.
Ausnahmen
Die AllowNew-Eigenschaft ist auf false gesetzt.
- oder -
Für den aktuellen Elementtyp konnte kein öffentlicher parameterloser Konstruktor gefunden werden.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der AddNew Methode veranschaulicht. 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.
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 Auflistung, die durch die Items Eigenschaft dargestellt wird, ein neues Element hinzu. Zum Hinzufügen eines neuen Elements wird die folgende Logik verwendet:
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.
Die Position des neuen Elements wird nachverfolgt, wird der Liste jedoch erst hinzugefügt, wenn eine der folgenden Bedingungen erfüllt ist:
Das Element wird explizit durch einen Aufruf von EndNew.
Das Element wird implizit von einem anderen Vorgang übernommen, der den Inhalt der Liste geändert hat, z. B. ein 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 das neue Element zugesichert wird.
