DataGridView.CellFormatting Händelse

public:
 event System::Windows::Forms::DataGridViewCellFormattingEventHandler ^ CellFormatting;

public event System.Windows.Forms.DataGridViewCellFormattingEventHandler CellFormatting;

public event System.Windows.Forms.DataGridViewCellFormattingEventHandler? CellFormatting;

member this.CellFormatting : System.Windows.Forms.DataGridViewCellFormattingEventHandler 

Public Custom Event CellFormatting As DataGridViewCellFormattingEventHandler 

Händelsetyp

Exempel

I följande kodexempel visas hur du hanterar händelsen CellFormatting .

void dataGridView1_CellFormatting( Object^ /*sender*/, DataGridViewCellFormattingEventArgs^ e )
{
   // If the column is the Artist column, check the
   // value.
   if ( this->dataGridView1->Columns[ e->ColumnIndex ]->Name->Equals( "Artist" ) )
   {
      if ( e->Value != nullptr )
      {
         // Check for the string "pink" in the cell.
         String^ stringValue = dynamic_cast<String^>(e->Value);
         stringValue = stringValue->ToLower();
         if ( (stringValue->IndexOf( "pink" ) > -1) )
         {
            DataGridViewCellStyle^ pinkStyle = gcnew DataGridViewCellStyle;

            //Change the style of the cell.
            pinkStyle->BackColor = Color::Pink;
            pinkStyle->ForeColor = Color::Black;
            pinkStyle->Font = gcnew System::Drawing::Font( "Times New Roman",8,FontStyle::Bold );
            e->CellStyle = pinkStyle;
         }
         
      }
   }
   else
   if ( this->dataGridView1->Columns[ e->ColumnIndex ]->Name->Equals( "Release Date" ) )
   {
      ShortFormDateFormat( e );
   }
}


//Even though the date internaly stores the year as YYYY, using formatting, the
//UI can have the format in YY.  
void ShortFormDateFormat( DataGridViewCellFormattingEventArgs^ formatting )
{
   if ( formatting->Value != nullptr )
   {
      try
      {
         System::Text::StringBuilder^ dateString = gcnew System::Text::StringBuilder;
         DateTime theDate = DateTime::Parse( formatting->Value->ToString() );
         dateString->Append( theDate.Month );
         dateString->Append( "/" );
         dateString->Append( theDate.Day );
         dateString->Append( "/" );
         dateString->Append( theDate.Year.ToString()->Substring( 2 ) );
         formatting->Value = dateString->ToString();
         formatting->FormattingApplied = true;
      }
      catch ( Exception^ /*notInDateFormat*/ ) 
      {
         // Set to false in case there are other handlers interested trying to
         // format this DataGridViewCellFormattingEventArgs instance.
         formatting->FormattingApplied = false;
      }

   }
}

private void dataGridView1_CellFormatting(object sender, DataGridViewCellFormattingEventArgs e)
{
    // If the column is the Artist column, check the
    // value.
    if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Artist")
    {
        if (e.Value != null)
        {
            // Check for the string "pink" in the cell.
            string stringValue = (string)e.Value;
            stringValue = stringValue.ToLower();
            if ((stringValue.IndexOf("pink") > -1))
            {
                e.CellStyle.BackColor = Color.Pink;
            }
        }
    }
    else if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Release Date")
    {
        ShortFormDateFormat(e);
    }
}

//Even though the date internaly stores the year as YYYY, using formatting, the
//UI can have the format in YY.  
private static void ShortFormDateFormat(DataGridViewCellFormattingEventArgs formatting)
{
    if (formatting.Value != null)
    {
        try
        {
            System.Text.StringBuilder dateString = new System.Text.StringBuilder();
            DateTime theDate = DateTime.Parse(formatting.Value.ToString());

            dateString.Append(theDate.Month);
            dateString.Append("/");
            dateString.Append(theDate.Day);
            dateString.Append("/");
            dateString.Append(theDate.Year.ToString().Substring(2));
            formatting.Value = dateString.ToString();
            formatting.FormattingApplied = true;
        }
        catch (FormatException)
        {
            // Set to false in case there are other handlers interested trying to
            // format this DataGridViewCellFormattingEventArgs instance.
            formatting.FormattingApplied = false;
        }
    }
}

Private Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting
    ' If the column is the Artist column, check the
    ' value.
    If Me.dataGridView1.Columns(e.ColumnIndex).Name _
        = "Artist" Then
        If e.Value IsNot Nothing Then

            ' Check for the string "pink" in the cell.
            Dim stringValue As String = _
            CType(e.Value, String)
            stringValue = stringValue.ToLower()
            If ((stringValue.IndexOf("pink") > -1)) Then
                e.CellStyle.BackColor = Color.Pink
            End If

        End If
    ElseIf Me.dataGridView1.Columns(e.ColumnIndex).Name _
        = "Release Date" Then
        ShortFormDateFormat(e)
    End If
End Sub

'Even though the date internaly stores the year as YYYY, using formatting, the
'UI can have the format in YY.  
Private Shared Sub ShortFormDateFormat(ByVal formatting As DataGridViewCellFormattingEventArgs)
    If formatting.Value IsNot Nothing Then
        Try
            Dim dateString As System.Text.StringBuilder = New System.Text.StringBuilder()
            Dim theDate As Date = DateTime.Parse(formatting.Value.ToString())

            dateString.Append(theDate.Month)
            dateString.Append("/")
            dateString.Append(theDate.Day)
            dateString.Append("/")
            dateString.Append(theDate.Year.ToString().Substring(2))
            formatting.Value = dateString.ToString()
            formatting.FormattingApplied = True
        Catch notInDateFormat As FormatException
            ' Set to false in case there are other handlers interested trying to
            ' format this DataGridViewCellFormattingEventArgs instance.
            formatting.FormattingApplied = False
        End Try
    End If
End Sub

Kommentarer

Som standard DataGridView försöker kontrollen konvertera en cells värde till ett format som är lämpligt för visning. Till exempel konverteras ett numeriskt värde till en sträng för visning i en textruta. Du kan ange vilken formateringskonvention som ska användas genom att ange Format egenskapen för de DataGridViewCellStyle returnerade egenskaperna, DefaultCellStyle till exempel egenskapen.

Om standardformateringen inte räcker till kan du anpassa formateringen genom att CellFormatting hantera händelsen. Med den här händelsen kan du ange det exakta visningsvärdet samt cellformaten, till exempel bakgrunds- och förgrundsfärg, som ska användas för cellvisningen. Det innebär att du kan hantera den här händelsen för alla typer av cellformatering, oavsett om själva cellvärdet behöver formatering.

Händelsen CellFormatting inträffar varje gång varje cell målas, så du bör undvika lång bearbetning när du hanterar den här händelsen. Den här händelsen inträffar också när cellen FormattedValue hämtas eller dess GetFormattedValue metod anropas.

När du hanterar händelsen CellFormattingConvertEventArgs.Value initieras egenskapen med cellvärdet. Om du anger anpassad konvertering från cellvärdet till visningsvärdet anger du ConvertEventArgs.Value egenskapen till det konverterade värdet, vilket säkerställer att det nya värdet är av den typ som anges av cellegenskapen FormattedValueType . Om du vill ange att ingen ytterligare värdeformatering krävs anger du DataGridViewCellFormattingEventArgs.FormattingApplied egenskapen till true.

När händelsehanteraren är klar, om ConvertEventArgs.Value är null eller inte är av rätt typ, eller DataGridViewCellFormattingEventArgs.FormattingApplied om egenskapen är false, Value formateras med egenskaperna Format, NullValue, DataSourceNullValueoch för FormatProvider cellformatet som returneras av DataGridViewCellFormattingEventArgs.CellStyle egenskapen, som initieras med cellegenskapen InheritedStyle .

Oavsett värdet för DataGridViewCellFormattingEventArgs.FormattingApplied egenskapen används visningsegenskaperna för objektet som returneras av DataGridViewCellFormattingEventArgs.CellStyle egenskapen för att återge cellen.

Mer information om anpassad formatering med hjälp av händelsen CellFormatting finns i How to: Customize Data Formatting in the Windows Forms DataGridView Control.

För att undvika prestandapåföljder vid hantering av den här händelsen kan du komma åt cellen via parametrarna för händelsehanteraren i stället för att komma åt cellen direkt.

Om du vill anpassa konverteringen av ett formaterat, användardefinierat värde till ett faktiskt cellvärde hanterar du CellParsing händelsen.

Mer information om hur du hanterar händelser finns i Hantera och höja händelser.

Se även

• DefaultCellStyle
• DataGridViewCellStyle
• Format
• FormatProvider
• NullValue
• DataSourceNullValue
• InheritedStyle
• Value
• FormattedValue
• FormattedValueType
• GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
• DataGridViewCellFormattingEventHandler
• DataGridViewCellFormattingEventArgs
• FormattingApplied
• CellStyle
• Value
• OnCellFormatting(DataGridViewCellFormattingEventArgs)
• CellParsing
• Cellformat i Windows Forms DataGridView-kontroll
• Så här gör du: Anpassa dataformatering i Windows Forms DataGridView-kontroll
• DataGridView Control (Windows Forms)