DataGridView.DefaultValuesNeeded Ereignis

Definition

Tritt auf, wenn der Benutzer die Zeile für neue Datensätze eingibt, sodass diese mit Standarddaten 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 von einer separaten Methode (nicht implementiert) abgerufen, die eine eindeutige Kunden-ID generiert.

Um dieses Beispiel auszuführen, ersetzen Sie die Spaltennamen durch die Namen der Spaltenobjekte aus einem tatsächlichen DataGridView Steuerelement, und geben Sie entsprechende Standardwerte an. Wenn Sie Spalten nach Name angeben, müssen Sie den Namen des Spaltenobjekts und nicht den Spaltenheadertext 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 nach neuen Datensätzen auffüllen, wenn der Benutzer die Zeile eingibt. Die Anfangswerte für die Zeile stammen aus der DefaultNewRowValue Eigenschaft der, die von der DataGridViewCell Eigenschaft jeder Spalte CellTemplate zurückgegeben wird.

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 auftritt. Wenn Sie die DataGridViewRowEventArgs.Row Eigenschaft in Ihrem Ereignishandler auffüllen, werden die Werte direkt der Datenquelle hinzugefügt.

Im virtuellen Modus tritt das Ereignis nach dem Auftreten dieses Ereignisses CellValuePushed 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 und ruft die Werte ab, die CellValuePushed Sie im Ereignis gespeichert haben, die dann angezeigt werden.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen