DataGridView.CellValidating Ereignis

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Tritt ein, wenn eine Zelle den Eingabefokus verliert, und aktiviert die Inhaltsvalidierung.

public:
 event System::Windows::Forms::DataGridViewCellValidatingEventHandler ^ CellValidating;

public event System.Windows.Forms.DataGridViewCellValidatingEventHandler CellValidating;

public event System.Windows.Forms.DataGridViewCellValidatingEventHandler? CellValidating;

member this.CellValidating : System.Windows.Forms.DataGridViewCellValidatingEventHandler

Public Custom Event CellValidating As DataGridViewCellValidatingEventHandler

Ereignistyp

DataGridViewCellValidatingEventHandler

Beispiele

Im folgenden Codebeispiel wird das CellValidating Ereignis behandelt, um sicherzustellen, dass nur positive ganze Zahlen vom Benutzer eingegeben werden. Dieses Beispiel ist Teil eines größeren Beispiels, das VirtualMode im Referenzthema verfügbar ist.

void VirtualConnector::dataGridView1_CellValidating
    (Object^ sender, DataGridViewCellValidatingEventArgs^ e)
{
    int newInteger;

    // Don't try to validate the 'new row' until finished 
    // editing since there
    // is not any point in validating its initial value.
    if (dataGridView1->Rows[e->RowIndex]->IsNewRow) 
    {
        return; 
    }
    if (!Int32::TryParse(e->FormattedValue->ToString(), 
        newInteger) || (newInteger < 0))
    {
        e->Cancel = true;
    }
}

private void dataGridView1_CellValidating(object sender,
    DataGridViewCellValidatingEventArgs e)
{
    dataGridView1.Rows[e.RowIndex].ErrorText = "";
    int newInteger;

    // Don't try to validate the 'new row' until finished 
    // editing since there
    // is not any point in validating its initial value.
    if (dataGridView1.Rows[e.RowIndex].IsNewRow) { return; }
    if (!int.TryParse(e.FormattedValue.ToString(),
        out newInteger) || newInteger < 0)
    {
        e.Cancel = true;
        dataGridView1.Rows[e.RowIndex].ErrorText = "the value must be a non-negative integer";
    }
}

Private Sub dataGridView1_CellValidating(ByVal sender As Object, _
    ByVal e _
    As DataGridViewCellValidatingEventArgs) _
    Handles dataGridView1.CellValidating

    Me.dataGridView1.Rows(e.RowIndex).ErrorText = ""
    Dim newInteger As Integer

    ' Don't try to validate the 'new row' until finished 
    ' editing since there
    ' is not any point in validating its initial value.
    If dataGridView1.Rows(e.RowIndex).IsNewRow Then Return
    If Not Integer.TryParse(e.FormattedValue.ToString(), newInteger) _
        OrElse newInteger < 0 Then

        e.Cancel = True
        Me.dataGridView1.Rows(e.RowIndex).ErrorText = "the value must be a non-negative integer"

    End If
End Sub

Hinweise

Durch das Abbrechen dieses Ereignisses werden die Änderungen an der aktuellen Zelle abgebrochen. Wenn dieses Ereignis im datengebundenen Modus abgebrochen wird, wird der neue Wert nicht an die zugrunde liegende Datenquelle gepusht. Wenn dieses Ereignis im virtuellen Modus abgebrochen wird, wird das CellValuePushed Ereignis nicht ausgelöst.

Behandeln Sie das CellValidated Ereignis, um die Verarbeitung nach der Validierung durchzuführen.

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

Gilt für:

Freigeben über