Cómo: Agregar filas a un DataTable

Para agregar nuevos registros a un conjunto de datos, se debe crear una nueva fila de datos y ésta debe agregarse a la colección DataRow (Rows) de una DataTable en el conjunto de datos. Los procedimientos siguientes muestran cómo crear una nueva fila e insertarla en una DataTable. Los ejemplos se proporcionan para los conjuntos de datos con y sin tipo.

Nota

Generalmente, las aplicaciones que utilizan controles enlazados a datos obtienen la funcionalidad de agregar nuevos registros a través del botón "Agregar nuevo" en un BindingNavigator Control.

Insertar un nuevo registro en un conjunto de datos con tipo

Para este ejemplo, se asume que un conjunto de datos tiene una Customers DataTable y dos columnas denominadas CustomerID y CompanyName. Los conjuntos de datos con tipo exponen los nombres de columna como propiedades del objeto DataRow con tipo; en este caso CustomersRow.

Para agregar un nuevo registro a un conjunto de datos con tipo

  • Declare una nueva instancia del conjunto de datos con tipo. En el ejemplo siguiente, se declara una nueva instancia de la clase CustomersRow, se le asigna una nueva fila, se rellenan las columnas con datos y se agrega la nueva fila a la colección Rows de la tabla Customers:

    Dim newCustomersRow As NorthwindDataSet.CustomersRow
    newCustomersRow = NorthwindDataSet1.Customers.NewCustomersRow()
    
    newCustomersRow.CustomerID = "ALFKI"
    newCustomersRow.CompanyName = "Alfreds Futterkiste"
    
    NorthwindDataSet1.Customers.Rows.Add(newCustomersRow)
    
    NorthwindDataSet.CustomersRow newCustomersRow = 
        northwindDataSet1.Customers.NewCustomersRow();
    
    newCustomersRow.CustomerID = "ALFKI";
    newCustomersRow.CompanyName = "Alfreds Futterkiste";
    
    northwindDataSet1.Customers.Rows.Add(newCustomersRow);
    

Insertar un nuevo registro en un conjunto de datos sin tipo

Para este ejemplo, se asume que un conjunto de datos sin tipo tiene una Customers DataTable con dos columnas denominadas CustomerID y CompanyName. Los conjuntos de datos sin tipo requieren conocimiento de nombres de columna o índices al codificar. Este ejemplo utiliza nombres de columna.

Para agregar un registro a un conjunto de datos sin tipo

  • Llame al método NewRow de una DataTable para crear una fila nueva y vacía. Esta nueva fila hereda su estructura de columna de la DataColumnCollection de la tabla de datos. El código siguiente crea una nueva fila, la rellena con datos y la agrega a la colección Rows de la tabla.

    Dim newCustomersRow As DataRow = DataSet1.Tables("Customers").NewRow()
    
    newCustomersRow("CustomerID") = "ALFKI"
    newCustomersRow("CompanyName") = "Alfreds Futterkiste"
    
    DataSet1.Tables("Customers").Rows.Add(newCustomersRow)
    
    DataRow newCustomersRow = dataSet1.Tables["Customers"].NewRow();
    
    newCustomersRow["CustomerID"] = "ALFKI";
    newCustomersRow["CompanyName"] = "Alfreds Futterkiste";
    
    dataSet1.Tables["Customers"].Rows.Add(newCustomersRow);
    

Vea también

Tareas

Cómo: Editar filas en un objeto DataTable

Cómo: Eliminar filas en un DataTable

Cómo: Confirmar cambios en un conjunto de datos

Cómo: Personalizar la forma de agregar elementos con el control BindingSource de formularios Windows Forms

Referencia

AddingNew

Columns

Conceptos

Agregar datos a DataTable

Otros recursos

Modificar datos en la aplicación

BindingSource (Componente)

Manipular datos en DataTable