DataGridView.DefaultValuesNeeded Ereignis
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.
Tritt auf, wenn der Benutzer die Zeile für neue Datensätze eingibt, damit sie mit Standardwerten aufgefüllt werden kann.
public:
event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;public event System.Windows.Forms.DataGridViewRowEventHandler DefaultValuesNeeded;public event System.Windows.Forms.DataGridViewRowEventHandler? DefaultValuesNeeded;member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler Ereignistyp
Beispiele
Das folgende Codebeispiel veranschaulicht, wie dieses Ereignis behandelt werden kann. Im Beispiel werden Zellen für die angegebenen Spalten mit Standardwerten aufgefüllt. Für die CustomerID Spalte wird der Wert aus einer separaten Methode (nicht implementiert) abgerufen, die eine eindeutige Kunden-ID generiert.
Ersetzen Sie zum Ausführen dieses Beispiels die Spaltennamen durch die Namen der Spaltenobjekte aus einem tatsächlichen DataGridView Steuerelement, und stellen Sie entsprechende Standardwerte bereit. Wenn Sie Spalten nach Namen angeben, müssen Sie den Namen des Spaltenobjekts und nicht den Spaltenüberschriftentext verwenden.
private void dataGridView1_DefaultValuesNeeded(object sender,
System.Windows.Forms.DataGridViewRowEventArgs e)
{
e.Row.Cells["Region"].Value = "WA";
e.Row.Cells["City"].Value = "Redmond";
e.Row.Cells["PostalCode"].Value = "98052-6399";
e.Row.Cells["Country"].Value = "USA";
e.Row.Cells["CustomerID"].Value = NewCustomerId();
}
Private Sub dataGridView1_DefaultValuesNeeded(ByVal sender As Object, _
ByVal e As System.Windows.Forms.DataGridViewRowEventArgs) _
Handles dataGridView1.DefaultValuesNeeded
With e.Row
.Cells("Region").Value = "WA"
.Cells("City").Value = "Redmond"
.Cells("PostalCode").Value = "98052-6399"
.Cells("Country").Value = "USA"
.Cells("CustomerID").Value = NewCustomerId()
End With
End Sub
Hinweise
Mit diesem Ereignis können Sie die Zeile für neue Datensätze auffüllen, wenn der Benutzer die Zeile eingibt. Die Anfangswerte für die Zeile stammen aus der DefaultNewRowValue Eigenschaft der DataGridViewCell von jeder Spalte zurückgegebenen Eigenschaft CellTemplate .
Im datengebundenen Modus werden alle Zellwerte für datengebundene Spalten in der externen Datenquelle gespeichert. Wenn der Benutzer die Zeile für neue Datensätze eingibt, wird eine neue Zeile in der Datenquelle erstellt, bevor das DefaultValuesNeeded Ereignis eintritt. Wenn Sie die DataGridViewRowEventArgs.Row Eigenschaft im Ereignishandler auffüllen, werden die Werte direkt zur Datenquelle hinzugefügt.
Im virtuellen Modus tritt das CellValuePushed Ereignis nach dem Auftreten dieses Ereignisses für jede Zelle in der neuen Zeile auf, sodass Sie die Standardwerte in Ihrem benutzerdefinierten Datenspeicher speichern können. Anschließend tritt das CellValueNeeded Ereignis für jede Zelle in der neuen Zeile auf, wobei die Werte abgerufen werden, die Sie im CellValuePushed Ereignis gespeichert haben, die dann angezeigt werden.
Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.
