DataGridViewCellParsingEventArgs, classe

Gérez l'événement CellParsing pour fournir une conversion de valeur personnalisée d'une valeur spécifiée par utilisateur à une valeur du type spécifié par la propriété ValueType de la cellule.

Lorsque vous gérez l'événement CellParsing, vous pouvez convertir la valeur vous-même ou vous pouvez personnaliser la conversion par défaut. Par exemple, vous pouvez convertir la valeur vous-même à l'aide de la méthode ParseFormattedValue de la cellule avec les convertisseurs de type de votre choix. Vous pouvez également laisser les convertisseurs de type par défaut analyser la valeur, mais modifiez les propriétés NullValue, DataSourceNullValue et FormatProvider de l'objet retourné par la propriété DataGridViewCellParsingEventArgs.InheritedCellStyle, qui est initialisée à l'aide de la propriété InheritedStyle de la cellule.

Lorsque vous convertissez la valeur vous-même, remplacez la valeur initiale mise en forme de la propriété ConvertEventArgs.Value avec la valeur convertie dans le type spécifié par la propriété ValueType de la cellule. Pour indiquer qu'aucune analyse supplémentaire n'est nécessaire, affectez la valeur true à la propriété DataGridViewCellParsingEventArgs.ParsingApplied.

Lorsque le gestionnaire d'événements a terminé, si le Value a la valeur référence Null (Nothing en Visual Basic) ou qu'il n'est pas du type correct, ou que la propriété ParsingApplied a la valeur false, le Value est analysé à l'aide de la méthode ParseFormattedValue de la cellule avec les convertisseurs de type par défaut. L'implémentation par défaut de cette méthode analyse la valeur à l'aide des propriétés NullValue, DataSourceNullValue et FormatProvider du style de cellule passé. Si la valeur n'est pas égale à NullValue, elle est analysée à l'aide de la propriété FormatProvider et des convertisseurs de type passés.

Pour personnaliser la conversion d'une valeur de cellule en une valeur mise en forme pour l'affichage, gérez l'événement CellFormatting.

Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

L'exemple de code suivant illustre l'utilisation de DataGridViewCellParsingEventArgs pour vérifier la validité des entrées de date.

// Handling CellParsing allows one to accept user input, then map it to a different
// internal representation.
private void dataGridView1_CellParsing(object sender, DataGridViewCellParsingEventArgs e)
{
    if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Release Date")
    {
        if (e != null)
        {
            if (e.Value != null)
            {
                try
                {
                    // Map what the user typed into UTC.
                    e.Value = DateTime.Parse(e.Value.ToString()).ToUniversalTime();
                    // Set the ParsingApplied property to 
                    // Show the event is handled.
                    e.ParsingApplied = true;

                }
                catch (FormatException)
                {
                    // Set to false in case another CellParsing handler
                    // wants to try to parse this DataGridViewCellParsingEventArgs instance.
                    e.ParsingApplied = false;
                }
            }
        }
    }
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework