DataGridView.DefaultValuesNeeded Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда пользователь вводит строку для новых записей, чтобы она была заполнена значениями по умолчанию.
public:
event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;public event System.Windows.Forms.DataGridViewRowEventHandler DefaultValuesNeeded;public event System.Windows.Forms.DataGridViewRowEventHandler? DefaultValuesNeeded;member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler Тип события
Примеры
В следующем примере кода показано, как можно обрабатывать это событие. В примере ячейки для заданных столбцов заполняются значениями по умолчанию. Для столбца CustomerID значение извлекается из отдельного метода (не реализованного), который создает уникальный идентификатор клиента.
Чтобы запустить этот пример, замените имена столбцов именами объектов столбцов из фактического DataGridView элемента управления и укажите соответствующие значения по умолчанию. При указании столбцов по имени необходимо использовать имя объекта столбца, а не текст заголовка столбца.
private void dataGridView1_DefaultValuesNeeded(object sender,
System.Windows.Forms.DataGridViewRowEventArgs e)
{
e.Row.Cells["Region"].Value = "WA";
e.Row.Cells["City"].Value = "Redmond";
e.Row.Cells["PostalCode"].Value = "98052-6399";
e.Row.Cells["Country"].Value = "USA";
e.Row.Cells["CustomerID"].Value = NewCustomerId();
}
Private Sub dataGridView1_DefaultValuesNeeded(ByVal sender As Object, _
ByVal e As System.Windows.Forms.DataGridViewRowEventArgs) _
Handles dataGridView1.DefaultValuesNeeded
With e.Row
.Cells("Region").Value = "WA"
.Cells("City").Value = "Redmond"
.Cells("PostalCode").Value = "98052-6399"
.Cells("Country").Value = "USA"
.Cells("CustomerID").Value = NewCustomerId()
End With
End Sub
Комментарии
Это событие позволяет заполнить строку для новых записей, когда пользователь вводит строку. Начальные значения строки приходят из DefaultNewRowValue свойства возвращаемого DataGridViewCell свойством каждого столбца CellTemplate .
В режиме привязки к данным все значения ячеек для привязанных к данным столбцов хранятся во внешнем источнике данных. Когда пользователь вводит строку для новых записей, перед событием создается новая строка в источнике DefaultValuesNeeded данных. При заполнении DataGridViewRowEventArgs.Row свойства в обработчике событий значения добавляются непосредственно в источник данных.
В виртуальном режиме после этого события событие происходит для каждой ячейки в новой строке, CellValuePushed чтобы сохранить значения по умолчанию в пользовательском хранилище данных. CellValueNeeded Затем событие происходит для каждой ячейки в новой строке, извлекая значения, сохраненные в CellValuePushed событии, которые затем отображаются.
Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".
