DataGridView.CurrentCell Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает ячейку, которая является активной в данный момент.

public:
 property System::Windows::Forms::DataGridViewCell ^ CurrentCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell CurrentCell { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.CurrentCell : System.Windows.Forms.DataGridViewCell with get, set

Public Property CurrentCell As DataGridViewCell

Значение свойства

DataGridViewCell

Объект DataGridViewCell, представляющий текущую ячейку, или значение null, если текущая ячейка отсутствует. По умолчанию используется первая ячейка в первом столбце или значение null, если в элементе управления отсутствуют ячейки.

Атрибуты

BrowsableAttribute

Исключения

InvalidOperationException

Не удается задать значение этого свойства, поскольку изменения в текущей ячейке не могут быть зафиксированы или отменены.

-или-

Указанная ячейка при задании этого свойства находится в скрытой строке или столбце.

Вызов с повторным входом разрешен, только если DataGridView привязан к DataSource. Вызов с повторным входом происходит вследствие изменения базовых данных.

ArgumentException

Указанная при задании этого свойства ячейка отсутствует в DataGridView.

Примеры

В следующем примере кода показано, как убедиться, что текущая ячейка отображается после сортировки, задав FirstDisplayedCell для свойства ячейку, полученную с помощью CurrentCell свойства . Этот код работает только с неограниченным DataGridView элементом управления. DataGridView Если элемент управления привязан к внешнему источнику данных, текущая ячейка не сохраняется автоматически при сортировке.

Чтобы выполнить этот пример, вставьте следующий код в форму с DataGridView именем dataGridView1. В C# необходимо также подключить Sorted событие к обработчику событий.

private void dataGridView1_Sorted(object sender, EventArgs e)
{
    this.dataGridView1.FirstDisplayedCell = this.dataGridView1.CurrentCell;
}

Private Sub dataGridView1_Sorted(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles dataGridView1.Sorted

    Me.dataGridView1.FirstDisplayedCell = Me.dataGridView1.CurrentCell

End Sub

Комментарии

При установке ячейки в качестве текущей ячейки она будет прокручиваться в представление, если она не отображается в данный момент. Текущая ячейка не может быть ячейкой заголовка, отключенной ячейкой или ячейкой в скрытой строке или столбце.

Вы можете присвоить этому свойству значение , null чтобы временно удалить прямоугольник фокуса, но когда элемент управления получает фокус и значение этого свойства равно null, ему автоматически присваивается значение FirstDisplayedCell свойства .

При изменении значения этого свойства SelectionChanged событие происходит до CurrentCellChanged события . Любой SelectionChanged обработчик событий, обращаюсь к свойству CurrentCell в данный момент, получит предыдущее значение.

При привязке к внешнему источнику DataGridView данных это свойство сбрасывается до значения по умолчанию.

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

• CurrentRow
• SelectionChanged
• CurrentCellChanged
• FirstDisplayedCell
• элемент управления DataGridView (Windows Forms)
• Практическое руководство. Считывание и установка значения текущей ячейки элемента управления DataGridView в Windows Forms