DataGridView.DefaultValuesNeeded Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Treedt op wanneer de gebruiker de rij voor nieuwe records invoert, zodat deze kan worden gevuld met standaardwaarden.
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 Gebeurtenistype
Voorbeelden
In het volgende codevoorbeeld ziet u hoe deze gebeurtenis kan worden verwerkt. In het voorbeeld worden cellen voor de opgegeven kolommen gevuld met standaardwaarden. Voor de CustomerID kolom wordt de waarde opgehaald uit een afzonderlijke methode (niet geïmplementeerd) waarmee een unieke klant-id wordt gegenereerd.
Als u dit voorbeeld wilt uitvoeren, vervangt u de kolomnamen door de namen van de kolomobjecten uit een daadwerkelijk DataGridView besturingselement en geeft u de juiste standaardwaarden op. Wanneer u kolommen op naam opgeeft, moet u de naam van het kolomobject en niet de kolomkoptekst gebruiken.
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
Opmerkingen
Met deze gebeurtenis kunt u de rij voor nieuwe records vullen wanneer de gebruiker de rij invoert. De initiële waarden voor de rij zijn afkomstig van de DefaultNewRowValue eigenschap van de DataGridViewCell kolom die wordt geretourneerd door de eigenschap van CellTemplate elke kolom.
In de gegevensgebonden modus worden alle celwaarden voor gegevensgebonden kolommen opgeslagen in de externe gegevensbron. Wanneer de gebruiker de rij voor nieuwe records invoert, wordt er een nieuwe rij gemaakt in de gegevensbron voordat de DefaultValuesNeeded gebeurtenis plaatsvindt. Wanneer u de eigenschap in de DataGridViewRowEventArgs.Row gebeurtenis-handler vult, worden de waarden rechtstreeks aan de gegevensbron toegevoegd.
Nadat deze gebeurtenis zich in de virtuele modus voordoet, vindt de CellValuePushed gebeurtenis plaats voor elke cel in de nieuwe rij, zodat u de standaardwaarden in uw aangepaste gegevensarchief kunt opslaan. Vervolgens vindt de CellValueNeeded gebeurtenis plaats voor elke cel in de nieuwe rij, waarbij de waarden worden opgehaald die u hebt opgeslagen in de CellValuePushed gebeurtenis, die vervolgens worden weergegeven.
Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.
