DataGridViewCellValidatingEventArgs Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Quelle:: DataGridViewCellValidatingEventArgs.cs

Quelle:: DataGridViewCellValidatingEventArgs.cs

Quelle:: DataGridViewCellValidatingEventArgs.cs

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.

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:

Produkt	Versionen
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

AI Skills Fest

Freigeben über