DataGridView.DefaultValuesNeeded 이벤트

정의

기본값으로 채워질 수 있도록 사용자가 새 레코드에 대한 행을 입력할 때 발생합니다.Occurs when the user enters the row for new records so that it can be populated with default values.

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 

예제

다음 코드 예제에서는이 이벤트를 처리할 수 있는 방법을 보여 줍니다.The following code example illustrates how this event can be handled. 예제에서는 지정 된 열에 대 한 셀은 기본 값으로 채워집니다.In the example, cells for the given columns are populated with default values. CustomerID 열의 경우 고유한 고객 ID를 생성 하는 별도의 메서드 (구현 되지 않음)에서 값을 검색 합니다.For the CustomerID column, the value is retrieved from a separate method (not implemented) that generates a unique customer ID.

이 예를 실행 하려면 열 이름을 실제 DataGridView 컨트롤의 열 개체 이름으로 바꾸고 적절 한 기본값을 제공 합니다.To run this example, replace the column names with the names of the column objects from an actual DataGridView control and provide appropriate default values. 이름별으로 열을 지정할 때 열 개체와 열 머리글 텍스트가 아니라 개체의 이름을 사용 해야 합니다.When specifying columns by name, you must use the name of the column object and not the column header text.

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

설명

이 이벤트를 사용 하면 사용자가 행을 입력 하는 경우 새 레코드에 대 한 행을 채울 수 있습니다.This event lets you populate the row for new records when the user enters the row. 행의 초기 값은 각 열의 CellTemplate 속성에 의해 반환 되는 DataGridViewCellDefaultNewRowValue 속성에서 제공 됩니다.Initial values for the row come from the DefaultNewRowValue property of the DataGridViewCell returned by each column's CellTemplate property.

데이터 바인딩된 모드에서는 모든 셀 바인딩된 열은 외부 데이터 원본에 저장 된 데이터에 대 한 값입니다.In data bound mode, all cell values for data bound columns are stored in the external data source. 사용자가 새 레코드에 대 한 행을 입력 하면 DefaultValuesNeeded 이벤트가 발생 하기 전에 데이터 원본에 새 행이 생성 됩니다.When the user enters the row for new records, a new row is created in the data source before the DefaultValuesNeeded event occurs. 이벤트 처리기에서 DataGridViewRowEventArgs.Row 속성을 채우면 값이 데이터 소스에 직접 추가 됩니다.When you populate the DataGridViewRowEventArgs.Row property in your event handler, the values are added directly to the data source.

가상 모드에서이 이벤트가 발생 한 후에는 새 행의 각 셀에 대해 CellValuePushed 이벤트가 발생 하 여 사용자 지정 데이터 저장소에 기본값을 저장할 수 있습니다.In virtual mode, after this event occurs, the CellValuePushed event occurs for each cell in the new row so that you can store the default values in your custom data store. 그런 다음 CellValueNeeded 이벤트는 새 행의 각 셀에 대해 발생 하며, CellValuePushed 이벤트에 저장 한 값을 검색 하 여 표시 됩니다.Then, the CellValueNeeded event occurs for each cell in the new row, retrieving the values that you stored in the CellValuePushed event, which are then displayed.

이벤트를 처리 하는 방법에 대 한 자세한 내용은 참조 하세요. 이벤트 처리 및 발생합니다.For more information about how to handle events, see Handling and Raising Events.

적용 대상

추가 정보