DataGridViewCellValidatingEventArgs Klasse

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Stellt Daten für das CellValidating-Ereignis eines DataGridView-Steuerelements bereit.

public ref class DataGridViewCellValidatingEventArgs : System::ComponentModel::CancelEventArgs
public class DataGridViewCellValidatingEventArgs : System.ComponentModel.CancelEventArgs
type DataGridViewCellValidatingEventArgs = class
    inherit CancelEventArgs
Public Class DataGridViewCellValidatingEventArgs
Inherits CancelEventArgs
Vererbung
Object
EventArgs
CancelEventArgs
DataGridViewCellValidatingEventArgs

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

Mit DataGridView.CellValidating dem -Ereignis können Sie Änderungen an der aktuellen Zelle abbrechen, wenn der neue Wert ungültig ist. Verwenden Sie die FormattedValue -Eigenschaft, um den aktuellen Wert zu bestimmen. Um den Zustand der aktuellen Zelle zu bestimmen, verwenden Sie die RowIndex Eigenschaften und ColumnIndex , um über die Auflistung auf die DataGridView.Rows Zelle zuzugreifen. Um die Änderung abzubrechen, legen Sie die Cancel -Eigenschaft auf fest true.

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 DataGridView.CellValuePushed Ereignis nicht ausgelöst.

Eigenschaften

Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.

(Geerbt von CancelEventArgs)
ColumnIndex

Ruft den Spaltenindex der zu überprüfenden Zelle ab.
FormattedValue

Ruft den formatierten Inhalt der zu überprüfenden Zelle ab.
RowIndex

Ruft den Zeilenindex der zu überprüfenden Zelle ab.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen