Esta documentación está archivada y no tiene mantenimiento.

DataGridViewCellParsingEventArgs (Clase)

Proporciona datos para el evento CellParsing de un control DataGridView.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public class DataGridViewCellParsingEventArgs : ConvertEventArgs
public class DataGridViewCellParsingEventArgs extends ConvertEventArgs
public class DataGridViewCellParsingEventArgs extends ConvertEventArgs
No aplicable.

Controle el evento CellParsing para proporcionar la conversión de valor personalizada de un valor especificado por el usuario a un valor del tipo especificado por la propiedad ValueType de la celda.

Cuando controla el evento CellParsing, puede convertir el valor o puede personalizar la conversión predeterminada. Por ejemplo, puede convertir el valor utilizando el método ParseFormattedValue de la celda con los convertidores de tipos que desee. Como alternativa, puede permitir que los convertidores de tipos predeterminados analicen el valor, pero modifique las propiedades NullValue, DataSourceNullValue y FormatProvider del objeto devuelto por la propiedad DataGridViewCellParsingEventArgs.InheritedCellStyle, que se inicializa utilizando la propiedad InheritedStyle de celda.

Cuando convierta el valor, reemplace el valor inicial con formato de la propiedad ConvertEventArgs.Value con el valor convertido del tipo especificado por la propiedad ValueType de celda. Para indicar que no es necesario realizar ningún análisis adicional, establezca la propiedad DataGridViewCellParsingEventArgs.ParsingApplied en true.

Cuando el controlador de eventos finaliza, si Value es referencia null (Nothing en Visual Basic) o no es del tipo correcto, o la propiedad ParsingApplied es false, se analiza Value utilizando el método ParseFormattedValue de celda con los convertidores de tipos predeterminados. La implementación predeterminada de este método analiza el valor utilizando las propiedades NullValue, DataSourceNullValue y FormatProvider del estilo de celda pasado. Si el valor no es igual a NullValue, el valor se analiza utilizando la propiedad FormatProvider y los convertidores de tipo pasados.

Para personalizar la conversión de un valor de celda a un valor con formato para la presentación, controle el evento CellFormatting.

Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.

En el ejemplo de código siguiente se muestra cómo utilizar DataGridViewCellParsingEventArgs para comprobar la validez de las entradas de fecha.

// 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;
                }
            }
        }
    }
}

System.Object
   System.EventArgs
     System.Windows.Forms.ConvertEventArgs
      System.Windows.Forms.DataGridViewCellParsingEventArgs

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: