DataGridView.DefaultValuesNeeded Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridView.cs

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

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

DataGridViewRowEventHandler

Příklady

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

Pokud chcete tento příklad spustit, 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 je nutné 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 pro nové záznamy, když uživatel zadá řádek. Počáteční hodnoty řádku pocházejí z DefaultNewRowValue vlastnosti DataGridViewCell vrácené vlastností každého sloupce 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 nový řádek předtím, než dojde k DefaultValuesNeeded události. Při naplnění DataGridViewRowEventArgs.Row vlastnosti v obslužné rutině události se hodnoty přidají přímo do zdroje dat.

V virtuálním režimu po této události dojde CellValuePushed 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. CellValueNeeded Pak dojde k události pro každou buňku v novém řádku a načte hodnoty, které jste uložili v CellValuePushed události, které se pak zobrazí.

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

Viz také

• Ovládací prvek DataGridView (Windows Forms)