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 , которые затем отображаются.

Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.

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

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