DataGridViewCellValidatingEventArgs Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Adatokat biztosít egy CellValidating vezérlő eseményéhez DataGridView .
public ref class DataGridViewCellValidatingEventArgs : System::ComponentModel::CancelEventArgs
public class DataGridViewCellValidatingEventArgs : System.ComponentModel.CancelEventArgs
type DataGridViewCellValidatingEventArgs = class
inherit CancelEventArgs
Public Class DataGridViewCellValidatingEventArgs
Inherits CancelEventArgs
- Öröklődés
Példák
Az alábbi példakód kezeli az CellValidating eseményt, hogy a felhasználó csak pozitív egész számokat adja meg. Ez a példa egy nagyobb, a VirtualMode referenciatémában elérhető példa része.
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
Megjegyzések
Az DataGridView.CellValidating esemény lehetővé teszi az aktuális cella módosításainak megszakítását, ha az új érték érvénytelen.
FormattedValue Az aktuális érték meghatározásához használja a tulajdonságot. Az aktuális cella állapotának meghatározásához használja az és RowIndex a ColumnIndex tulajdonságokat a cella gyűjteményen keresztüli DataGridView.Rows eléréséhez. A módosítás megszakításához állítsa a tulajdonságot a Cancel következőre true: .
Ha ezt az eseményt adathoz kötött módban szakítja meg, a rendszer nem küldi el az új értéket a mögöttes adatforrásba. Ha ezt az eseményt virtuális módban megszakítja, az DataGridView.CellValuePushed esemény nem lesz előállítva.
Tulajdonságok
| Név | Description |
|---|---|
| Cancel |
Lekéri vagy beállít egy értéket, amely jelzi, hogy az eseményt le kell-e mondani. (Öröklődés forrása CancelEventArgs) |
| ColumnIndex |
Lekéri az érvényesítendő cella oszlopindexét. |
| FormattedValue |
Lekéri annak a cellának a formázott tartalmát, amelyet ellenőrizni kell. |
| RowIndex |
Lekéri az érvényesítendő cella sorindexét. |
Metódusok
| Név | Description |
|---|---|
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |