DataGridView.DefaultValuesNeeded Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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;

member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler 

Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler 

Type d'événement

DataGridViewRowEventHandler

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.

Voir aussi

• DataGridView, contrôle (Windows Forms)