DataGridViewCellValidatingEventArgs Класс

Определение

Предоставляет данные для события CellValidating элемента управления DataGridView.Provides data for the CellValidating event of a DataGridView control.

public ref class DataGridViewCellValidatingEventArgs : System::ComponentModel::CancelEventArgs
public class DataGridViewCellValidatingEventArgs : System.ComponentModel.CancelEventArgs
type DataGridViewCellValidatingEventArgs = class
    inherit CancelEventArgs
Public Class DataGridViewCellValidatingEventArgs
Inherits CancelEventArgs
Наследование
DataGridViewCellValidatingEventArgs

Примеры

В следующем примере кода событие обрабатывается CellValidating , чтобы гарантировать, что пользователь вводит только положительные целые числа.The following code example handles the CellValidating event to ensure that only positive integers are entered by the user. Этот пример является частью более крупного примера, доступного в VirtualMode справочной статье.This example is part of a larger example available in the VirtualMode reference topic.

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

Комментарии

Это DataGridView.CellValidating событие позволяет отменить изменения в текущей ячейке, если новое значение недопустимо.The DataGridView.CellValidating event lets you cancel changes to the current cell when the new value is not valid. FormattedValueЧтобы определить текущее значение, используйте свойство.Use the FormattedValue property to determine the current value. Чтобы определить состояние текущей ячейки, используйте RowIndex ColumnIndex Свойства и для доступа к ячейке через DataGridView.Rows коллекцию.To determine the state of the current cell, use the RowIndex and ColumnIndex properties to access the cell through the DataGridView.Rows collection. Чтобы отменить изменение, присвойте Cancel свойству значение true .To cancel the change, set the Cancel property to true.

При отмене этого события в режиме с привязкой к данным новое значение не помещается в базовый источник данных.When this event is canceled in data-bound mode, the new value is not pushed to the underlying data source. При отмене этого события в виртуальном режиме DataGridView.CellValuePushed событие не будет вызвано.When this event is canceled in virtual mode, the DataGridView.CellValuePushed event will not be raised.

Свойства

Cancel

Возвращает или задает значение, показывающее, следует ли отменить событие.Gets or sets a value indicating whether the event should be canceled.

(Унаследовано от CancelEventArgs)
ColumnIndex

Возвращает индекс столбца, в котором расположена ячейка, нуждающаяся в проверке.Gets the column index of the cell that needs to be validated.

FormattedValue

Возвращает отформатированное содержимое ячейки, которая должна быть проверена.Gets the formatted contents of the cell that needs to be validated.

RowIndex

Возвращает индекс строки, в которой расположена ячейка, нуждающаяся в проверке.Gets the row index of the cell that needs to be validated.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

См. также раздел