Compartilhar via


DataGridViewCellParsingEventArgs Classe

Definição

Fornece dados para o evento CellParsing de um controle DataGridView.

public ref class DataGridViewCellParsingEventArgs : System::Windows::Forms::ConvertEventArgs
public class DataGridViewCellParsingEventArgs : System.Windows.Forms.ConvertEventArgs
type DataGridViewCellParsingEventArgs = class
    inherit ConvertEventArgs
Public Class DataGridViewCellParsingEventArgs
Inherits ConvertEventArgs
Herança
DataGridViewCellParsingEventArgs

Exemplos

O exemplo de código a seguir demonstra o uso DataGridViewCellParsingEventArgs de para marcar a validade das entradas de data.

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

Comentários

Manipule o CellParsing evento para fornecer conversão de valor personalizado de um valor especificado pelo usuário para um valor no tipo especificado pela propriedade da célula ValueType .

Ao manipular o CellParsing evento, você pode converter o valor por conta própria ou personalizar a conversão padrão. Por exemplo, você pode converter o valor por conta própria usando o método de célula ParseFormattedValue com conversores de tipo de sua escolha. Como alternativa, você pode permitir que os conversores de tipo padrão analisem o valor, mas modifique as NullValuepropriedades , DataSourceNullValuee FormatProvider do objeto retornado pela DataGridViewCellParsingEventArgs.InheritedCellStyle propriedade , que é inicializada usando a propriedade cell InheritedStyle .

Ao converter o valor por conta própria, substitua o valor inicial formatado da ConvertEventArgs.Value propriedade pelo valor convertido no tipo especificado pela propriedade da célula ValueType . Para indicar que nenhuma análise adicional é necessária, defina a DataGridViewCellParsingEventArgs.ParsingApplied propriedade como true.

Quando o manipulador de eventos for concluído, se o Value for null ou não for do tipo correto ou se a ParsingApplied propriedade for false, o Value será analisado usando o método de célula ParseFormattedValue com conversores de tipo padrão. A implementação padrão desse método analisa o valor usando as NullValuepropriedades , DataSourceNullValuee FormatProvider do estilo de célula passado. Se o valor não for igual a NullValue, o valor será analisado usando a FormatProvider propriedade e os conversores de tipo passados.

Para personalizar a conversão de um valor de célula em um valor formatado para exibição, manipule o CellFormatting evento.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Construtores

DataGridViewCellParsingEventArgs(Int32, Int32, Object, Type, DataGridViewCellStyle)

Inicializa uma nova instância da classe DataGridViewCellParsingEventArgs.

Propriedades

ColumnIndex

Obtém o índice da coluna dos dados de célula que requerem análise.

DesiredType

Obtém o tipo de dados do valor desejado.

(Herdado de ConvertEventArgs)
InheritedCellStyle

Obtém ou define o estilo aplicado à célula editada.

ParsingApplied

Obtém ou define um valor que indica se o valor da célula foi analisado com êxito.

RowIndex

Obtém o índice da linha da célula que requer análise.

Value

Obtém ou define o valor do ConvertEventArgs.

(Herdado de ConvertEventArgs)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também