Sdílet prostřednictvím


DataGridView.DefaultValuesNeeded Událost

Definice

Nastane, když uživatel zadá řádek pro nové záznamy, aby se mohl naplnit výchozími hodnotami.

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 

Event Type

Příklady

Následující příklad kódu ukazuje, jak lze tuto událost zpracovat. V příkladu se buňky pro dané sloupce naplní výchozími hodnotami. CustomerID Pro sloupec se hodnota načte ze samostatné metody (neimplementované), která generuje jedinečné ID zákazníka.

Chcete-li spustit tento příklad, nahraďte názvy sloupců názvy objektů sloupců ze skutečného DataGridView ovládacího prvku a zadejte odpovídající výchozí hodnoty. Při zadávání sloupců podle názvu musíte použít název objektu sloupce, nikoli text záhlaví sloupce.

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

Poznámky

Tato událost umožňuje naplnit řádek nových záznamů, když uživatel zadá řádek. Počáteční hodnoty řádku pocházejí z DefaultNewRowValue vlastnosti DataGridViewCell vrácené vlastností jednotlivých sloupců CellTemplate .

V režimu vázaném na data jsou všechny hodnoty buněk pro sloupce vázané na data uloženy v externím zdroji dat. Když uživatel zadá řádek pro nové záznamy, vytvoří se ve zdroji dat před událostí DefaultValuesNeeded nový řádek. Při naplnění DataGridViewRowEventArgs.Row vlastnosti v obslužné rutině události se hodnoty přidají přímo do zdroje dat.

Ve virtuálním režimu po výskytu CellValuePushed této události dojde k události pro každou buňku v novém řádku, abyste mohli uložit výchozí hodnoty ve vlastním úložišti dat. Pak událost CellValueNeeded nastane pro každou buňku v novém řádku a načte hodnoty, které jste v události uložili CellValuePushed a které se pak zobrazí.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Platí pro

Viz také