NewRow Method

DataTable.NewRow Method ()


Creates a new DataRow with the same schema as the table.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

public DataRow NewRow()

Return Value

Type: System.Data.DataRow

A DataRow with the same schema as the DataTable.

You must use the NewRow method to create new DataRow objects with the same schema as the DataTable. After creating a DataRow, you can add it to the DataRowCollection, through the DataTable object's Rows property. When you use NewRow to create new rows, the rows must be added to or deleted from the data table before you call Clear.

The following example creates a DataTable, adds two DataColumn objects that determine the table's schema, and creates several new DataRow objects using the NewRow method. Those DataRow objects are then added to the DataRowCollection using the Add method.

private void MakeDataTableAndDisplay()
    // Create new DataTable and DataSource objects.
    DataTable table = new DataTable();

    // Declare DataColumn and DataRow variables.
    DataColumn column;
    DataRow row; 
    DataView view;

    // Create new DataColumn, set DataType, ColumnName and add to DataTable.    
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";

    // Create second column.
    column = new DataColumn();
    column.DataType = Type.GetType("System.String");
    column.ColumnName = "item";

    // Create new DataRow objects and add to DataTable.    
    for(int i = 0; i < 10; i++)
        row = table.NewRow();
        row["id"] = i;
        row["item"] = "item " + i.ToString();

    // Create a DataView using the DataTable.
    view = new DataView(table);

    // Set a DataGrid control's DataSource to the DataView.
    dataGrid1.DataSource = view;

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft