DataGridViewCellParsingEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fornisce i dati per l'evento CellParsing di un controllo 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
Ereditarietà
Object
EventArgs
ConvertEventArgs
DataGridViewCellParsingEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato l'uso DataGridViewCellParsingEventArgs per verificare la validità delle voci di 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

Commenti

Gestire l'evento CellParsing per fornire la conversione del valore personalizzato da un valore specificato dall'utente a un valore nel tipo specificato dalla proprietà cella ValueType .

Quando si gestisce l'evento, è possibile convertire autonomamente il CellParsing valore oppure personalizzare la conversione predefinita. Ad esempio, è possibile convertire il valore usando il metodo cella ParseFormattedValue con convertitori di tipi della scelta. In alternativa, è possibile consentire ai convertitori di tipi predefiniti di analizzare il valore, ma modificare le NullValueproprietà , DataSourceNullValuee FormatProvider dell'oggetto restituito dalla DataGridViewCellParsingEventArgs.InheritedCellStyle proprietà, inizializzata usando la proprietà cell InheritedStyle .

Quando si converte il valore manualmente, sostituire il valore iniziale, formattato della ConvertEventArgs.Value proprietà con il valore convertito nel tipo specificato dalla proprietà cell ValueType . Per indicare che non è necessaria un'ulteriore analisi, impostare la DataGridViewCellParsingEventArgs.ParsingApplied proprietà su true.

Al termine del gestore eventi, se Value l'oggetto è null o non è del tipo corretto oppure la ParsingApplied proprietà è false, viene Value analizzata usando il metodo cella ParseFormattedValue con convertitori di tipi predefiniti. L'implementazione predefinita di questo metodo analizza il valore usando le NullValueproprietà , DataSourceNullValuee FormatProvider dello stile di cella passate. Se il valore non è uguale a NullValue, il valore viene analizzato usando la FormatProvider proprietà e i convertitori di tipi passati.

Per personalizzare la conversione di un valore di cella in un valore formattato per la visualizzazione, gestire l'evento CellFormatting .

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Costruttori

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

Inizializza una nuova istanza della classe DataGridViewCellParsingEventArgs.

Proprietà

ColumnIndex

Ottiene l'indice di colonna dei dati della cella che richiedono l'analisi.
DesiredType

Ottiene il tipo di dati del valore desiderato.

(Ereditato da ConvertEventArgs)
InheritedCellStyle

Ottiene o imposta lo stile applicato alla cella modificata.
ParsingApplied

Ottiene o imposta un valore che indica se il valore di una cella è stato analizzato correttamente.
RowIndex

Ottiene o imposta l'indice di riga della cella che richiede l'analisi.
Value

Ottiene o imposta il valore dell'oggetto ConvertEventArgs.

(Ereditato da ConvertEventArgs)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche