DataGridView.DefaultValuesNeeded Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Występuje, gdy użytkownik wprowadza wiersz dla nowych rekordów, aby można było wypełnić je wartościami domyślnymi.

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

Typ zdarzenia

DataGridViewRowEventHandler

Przykłady

Poniższy przykład kodu ilustruje sposób obsługi tego zdarzenia. W tym przykładzie komórki dla podanych kolumn są wypełniane wartościami domyślnymi. CustomerID W przypadku kolumny wartość jest pobierana z oddzielnej metody (nie zaimplementowanej), która generuje unikatowy identyfikator klienta.

Aby uruchomić ten przykład, zastąp nazwy kolumn nazwami obiektów kolumn z rzeczywistej DataGridView kontrolki i podaj odpowiednie wartości domyślne. Podczas określania kolumn według nazwy należy użyć nazwy obiektu kolumny, a nie tekstu nagłówka kolumny.

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

Uwagi

To zdarzenie umożliwia wypełnienie wiersza dla nowych rekordów po wprowadzeniu wiersza przez użytkownika. Początkowe wartości wiersza pochodzą z DefaultNewRowValue właściwości DataGridViewCell zwracanej przez właściwość każdej kolumny CellTemplate .

W trybie ograniczenia danych wszystkie wartości komórek dla powiązanych kolumn danych są przechowywane w zewnętrznym źródle danych. Gdy użytkownik wprowadzi wiersz dla nowych rekordów, nowy wiersz zostanie utworzony w źródle danych przed wystąpieniem DefaultValuesNeeded zdarzenia. Po wypełnieniu DataGridViewRowEventArgs.Row właściwości w procedurze obsługi zdarzeń wartości są dodawane bezpośrednio do źródła danych.

W trybie wirtualnym po wystąpieniu tego zdarzenia zdarzenie występuje dla każdej komórki w nowym wierszu, CellValuePushed aby można było przechowywać wartości domyślne w niestandardowym magazynie danych. CellValueNeeded Następnie zdarzenie występuje dla każdej komórki w nowym wierszu, pobierania wartości przechowywanych w CellValuePushed zdarzeniu, które następnie są wyświetlane.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Dotyczy

Zobacz też