DataGridView.DefaultValuesNeeded Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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ń.