Evaluar y enviar comentarios
Contraer todo/Expandir todo Contraer todo
Esta página es específica de
Microsoft Visual Studio 2008/.NET Framework 3.5

Hay además otras versiones disponibles para:
Biblioteca de clases de .NET Framework
DataGridViewCellParsingEventArgs (Clase)

Actualización: noviembre 2007

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)
Visual Basic (Declaración)
Public Class DataGridViewCellParsingEventArgs _
    Inherits ConvertEventArgs
Visual Basic (Uso)
Dim instance As DataGridViewCellParsingEventArgs
C#
public class DataGridViewCellParsingEventArgs : ConvertEventArgs
Visual C++
public ref class DataGridViewCellParsingEventArgs : public ConvertEventArgs
J#
public class DataGridViewCellParsingEventArgs extends ConvertEventArgs
JScript
public class DataGridViewCellParsingEventArgs extends ConvertEventArgs

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 nullNothingnullptrreferencia 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.

Visual Basic
' Handling CellParsing allows one to accept user input, then map it to a different
' internal representation.
Private Sub dataGridView1_CellParsing(ByVal sender As Object, _
    ByVal e As DataGridViewCellParsingEventArgs) _
    Handles dataGridView1.CellParsing

    If Me.dataGridView1.Columns(e.ColumnIndex).Name = _
        "Release Date" Then
        If e IsNot Nothing Then
            If e.Value IsNot Nothing Then
                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 ex As FormatException
                    ' Set to false in case another CellParsing handler
                    ' wants to try to parse this DataGridViewCellParsingEventArgs instance.
                    e.ParsingApplied = False
                End Try
            End If
        End If
    End If
End Sub
C#
// 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;
                }
            }
        }
    }
}
Visual C++
// Handling CellParsing allows one to accept user input, then map it to a different
// internal representation.
void dataGridView1_CellParsing( Object^ /*sender*/, DataGridViewCellParsingEventArgs^ e )
{
   if ( this->dataGridView1->Columns[ e->ColumnIndex ]->Name->Equals( "Release Date" ) )
   {
      if ( e != nullptr )
      {
         if ( e->Value != nullptr )
         {
            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^ /*ex*/ ) 
            {
               // 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
Todos los miembros static (Shared en Visual Basic) públicos 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Contenido de la comunidad   ¿Qué es Community Content?
Agregar contenido nuevo RSS  Anotaciones
Processing
© 2012 Microsoft. Reservados todos los derechos. Términos de uso | Marcas Registradas | Privacidad
Page view tracker