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 , которые затем отображаются.
Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.
