DataGridView.CellFormatting Ereignis

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 

Ereignistyp

Beispiele

Das folgende Codebeispiel zeigt, wie das CellFormatting Ereignis behandelt wird.

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

Hinweise

Standardmäßig versucht das Steuerelement, den DataGridView Wert einer Zelle in ein für die Anzeige geeignetes Format zu konvertieren. Beispielsweise wird ein numerischer Wert in eine Zeichenfolge für die Anzeige in einer Textfeldzelle konvertiert. Sie können die zu verwendende Formatierungskonvention angeben, indem Sie die Format Eigenschaft der DataGridViewCellStyle von Eigenschaften wie der DefaultCellStyle Eigenschaft zurückgegebenen Eigenschaften festlegen.

Wenn die Standardformatierung nicht ausreicht, können Sie die Formatierung anpassen, indem Sie das CellFormatting Ereignis behandeln. Mit diesem Ereignis können Sie den genauen Anzeigewert sowie die Zellenformatvorlagen angeben, z. B. Hintergrund- und Vordergrundfarbe, die für die Zellenanzeige verwendet werden sollen. Dies bedeutet, dass Sie dieses Ereignis für jede Art von Zellformatierung behandeln können, unabhängig davon, ob der Zellwert selbst eine Formatierung benötigt.

Das CellFormatting Ereignis tritt jedes Mal auf, wenn jede Zelle gezeichnet wird. Daher sollten Sie bei der Behandlung dieses Ereignisses eine langwierige Verarbeitung vermeiden. Dieses Ereignis tritt auch auf, wenn die Zelle FormattedValue abgerufen wird oder die GetFormattedValue Methode aufgerufen wird.

Wenn Sie das CellFormatting Ereignis behandeln, wird die ConvertEventArgs.Value Eigenschaft mit dem Zellwert initialisiert. Wenn Sie eine benutzerdefinierte Konvertierung vom Zellwert in den Anzeigewert bereitstellen, legen Sie die ConvertEventArgs.Value Eigenschaft auf den konvertierten Wert fest, und stellen Sie sicher, dass der neue Wert vom Typ ist, der von der Zelleigenschaft FormattedValueType angegeben wird. Um anzugeben, dass keine weitere Wertformatierung erforderlich ist, legen Sie die DataGridViewCellFormattingEventArgs.FormattingApplied Eigenschaft auf true.

Wenn der Ereignishandler abgeschlossen ist oder ConvertEventArgs.Valuenull nicht der richtige Typ ist oder die DataGridViewCellFormattingEventArgs.FormattingApplied Eigenschaft istfalse, wird dies Value mithilfe Formatder von der Eigenschaft zurückgegebenen , NullValueDataSourceNullValueund FormatProvider Eigenschaften der von der DataGridViewCellFormattingEventArgs.CellStyle Eigenschaft zurückgegebenen Zellenformatvorlage formatiert, die mithilfe der Zelleigenschaft InheritedStyle initialisiert wird.

Unabhängig vom Wert der DataGridViewCellFormattingEventArgs.FormattingApplied Eigenschaft werden die Anzeigeeigenschaften des objekts, das von der DataGridViewCellFormattingEventArgs.CellStyle Eigenschaft zurückgegeben wird, zum Rendern der Zelle verwendet.

Weitere Informationen zur benutzerdefinierten Formatierung mithilfe des CellFormatting Ereignisses finden Sie unter How to: Customize Data Formatting in the Windows Forms DataGridView Control.

Um Leistungsstrafen beim Behandeln dieses Ereignisses zu vermeiden, greifen Sie über die Parameter des Ereignishandlers auf die Zelle zu, anstatt direkt auf die Zelle zuzugreifen.

Um die Konvertierung eines formatierten, vom Benutzer angegebenen Werts in einen tatsächlichen Zellwert anzupassen, behandeln Sie das CellParsing Ereignis.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.

Weitere Informationen

• 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
• Zellenformatvorlagen im Windows Forms DataGridView-Steuerelement
• Vorgehensweise: Anpassen der Datenformatierung im Windows Forms DataGridView-Steuerelement
• DataGridView-Steuerelement (Windows Forms)