DataGridView.DefaultValuesNeeded Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit quand l’utilisateur ajoute la ligne pour de nouveaux enregistrements afin qu’elle puisse être remplie avec des valeurs par défaut.
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 Type d'événement
Exemples
L’exemple de code suivant illustre la façon dont cet événement peut être géré. Dans l’exemple, les cellules des colonnes données sont remplies avec les valeurs par défaut. Pour la CustomerID colonne, la valeur est récupérée à partir d’une méthode distincte (non implémentée) qui génère un ID client unique.
Pour exécuter cet exemple, remplacez les noms des colonnes par les noms des objets de colonne d’un contrôle réel DataGridView et fournissez les valeurs par défaut appropriées. Lorsque vous spécifiez des colonnes par nom, vous devez utiliser le nom de l’objet de colonne et non le texte d’en-tête de colonne.
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
Remarques
Cet événement vous permet de remplir la ligne pour les nouveaux enregistrements lorsque l’utilisateur entre la ligne. Les valeurs initiales de la ligne proviennent de la DefaultNewRowValue propriété du retourné par la DataGridViewCell propriété de CellTemplate chaque colonne.
En mode lié aux données, toutes les valeurs de cellule pour les colonnes liées aux données sont stockées dans la source de données externe. Lorsque l’utilisateur entre la ligne pour les nouveaux enregistrements, une nouvelle ligne est créée dans la source de données avant que l’événement DefaultValuesNeeded ne se produise. Lorsque vous renseignez la DataGridViewRowEventArgs.Row propriété dans votre gestionnaire d’événements, les valeurs sont ajoutées directement à la source de données.
En mode virtuel, une fois cet événement produit, l’événement CellValuePushed se produit pour chaque cellule de la nouvelle ligne afin que vous puissiez stocker les valeurs par défaut dans votre magasin de données personnalisé. Ensuite, l’événement CellValueNeeded se produit pour chaque cellule de la nouvelle ligne, récupérant les valeurs que vous avez stockées dans l’événement CellValuePushed , qui sont ensuite affichées.
Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.
