Sdílet prostřednictvím

DataGridView.CellParsing Událost

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll
Zdroj:
DataGridView.cs
Zdroj:
DataGridView.cs
Zdroj:
DataGridView.cs
Zdroj:
DataGridView.cs
Zdroj:
DataGridView.cs

Nastane, když buňka opustí režim úprav, pokud byla hodnota buňky změněna.

public:
 event System::Windows::Forms::DataGridViewCellParsingEventHandler ^ CellParsing;
public event System.Windows.Forms.DataGridViewCellParsingEventHandler CellParsing;
public event System.Windows.Forms.DataGridViewCellParsingEventHandler? CellParsing;
member this.CellParsing : System.Windows.Forms.DataGridViewCellParsingEventHandler 
Public Custom Event CellParsing As DataGridViewCellParsingEventHandler

Event Type

DataGridViewCellParsingEventHandler

Příklady

Následující příklad kódu ukazuje, jak zpracovat CellParsing událost. Ukazuje také, jak používat DataGridViewCellParsingEventArgs třídu.

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

Poznámky

Ve výchozím nastavení DataGridView se ovládací prvek pokusí převést uživatelem zadanou hodnotu zobrazenou v buňce na skutečnou hodnotu podkladové buňky v typu určeném vlastností buňky ValueType . Tento převod používá vlastnosti formátování stylu buňky vrácené vlastností buňky InheritedStyle .

Pokud standardní převod nevyhovuje vašim potřebám, zpracujte CellParsing událost a poskytněte převod vlastní hodnoty na požadovaný typ.

Uživatelé mohou přejít do režimu úprav pomocí metody určené EditMode vlastností a mohou opustit režim úprav, potvrzení změn v buňce, přesunutím na jinou buňku nebo stisknutím klávesy ENTER. Stisknutím klávesy ESC se vrátí všechny změny hodnoty před jejím potvrzením a CellParsing událost se nezobrazí. Událost CellParsing nastane pouze v případě, že hodnota buňky byla skutečně změněna, i když je konečná hodnota stejná jako původní hodnota. K tomu dochází také při CommitEdit zavolání metody.

Při zpracování CellParsing události můžete hodnotu převést sami nebo můžete přizpůsobit výchozí převod. Hodnotu můžete například převést sami pomocí metody buňky ParseFormattedValue s převaděči typů podle vašeho výběru. Alternativně můžete nechat výchozí převaděče typů parsovat hodnotu, ale upravit , a vlastnosti objektu vráceného DataGridViewCellParsingEventArgs.InheritedCellStyle vlastností, který je inicializován pomocí vlastnosti buňkyInheritedStyle.FormatProviderDataSourceNullValueNullValue

Při převodu hodnoty sami nahraďte počáteční formátovanou hodnotu ConvertEventArgs.Value vlastnosti převedenou hodnotou v typu určeném vlastností buňky ValueType . Chcete-li označit, že žádná další analýza není nutná, nastavte DataGridViewCellParsingEventArgs.ParsingApplied vlastnost na truehodnotu .

Po dokončení obslužné rutiny události, pokud ConvertEventArgs.Value je null nebo není správný typ, nebo DataGridViewCellParsingEventArgs.ParsingApplied je falsevlastnost je , Value je analyzována pomocí metody buňky ParseFormattedValue s výchozími převaděči typů. Výchozí implementace této metody parsuje hodnotu pomocí NullValue, DataSourceNullValuea FormatProvider vlastnosti stylu buňky předané. Pokud hodnota není rovna NullValue, hodnota je analyzována pomocí FormatProvider vlastnosti a převaděče typů předané.

Pokud chcete přizpůsobit převod hodnoty buňky na formátovanou hodnotu pro zobrazení, zpracujte CellFormatting událost.

Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.

Platí pro

Viz také