Insertar registros nuevos en una base de datos en aplicaciones de .NET Framework

Para insertar nuevos registros en una base de datos con ADO.NET en un proyecto de .NET Framework, el enfoque común es usar métodos TableAdapter . TableAdapters habilita la comunicación entre la aplicación y la base de datos. Proporcionan diferentes formas de insertar registros nuevos en una base de datos, en función de los requisitos de la aplicación. Puede usar el TableAdapter.Update método o uno de los métodos DBDirect de TableAdapter (en concreto, el TableAdapter.Insert método ).

En este artículo se describe cómo insertar registros en una base de datos para una aplicación compilada con ADO.NET y .NET Framework mediante Visual Basic (VB) o C#. Si la configuración de la aplicación usa Entity Framework 6, consulte Adición de una nueva entidad al contexto o para Entity Framework Core, consulte Adición de datos.

Prerrequisitos

• Para trabajar con métodos TableAdapter, debe tener una instancia disponible. Para obtener más información, consulte Creación y configuración de TableAdapters en aplicaciones de .NET Framework.

• Seguridad de .NET: debe tener acceso a la base de datos a la que intenta conectarse y permiso para realizar inserciones en la tabla deseada.

Elegir método de inserción

Hay diferentes enfoques para insertar registros en una base de datos en función del escenario de la aplicación. En la tabla siguiente se resumen las opciones:

Insertar registros nuevos mediante TableAdapters

Si la aplicación usa conjuntos de datos para almacenar datos, puede agregar nuevos registros al conjunto de datos deseado DataTable y, a continuación, llamar al TableAdapter.Update método . El TableAdapter.Update método envía los cambios en la DataTable base de datos a la base de datos, incluidos los registros modificados y eliminados.

Insertar nuevos registros con el método TableAdapter.Update

En el procedimiento siguiente se muestra cómo insertar nuevos registros en una base de datos mediante el TableAdapter.Update método :

1. Agregue nuevos registros al deseado DataTable creando un nuevo DataRow y agregándolo a la Rows colección.

2. Después de agregar las nuevas filas a DataTable, llame al método TableAdapter.Update. Puede controlar la cantidad de datos que se van a actualizar pasando uno de los siguientes valores de parámetro:

   • Un DataSet entero
   • Una operación DataTable
   • Matriz de DataRows
   • Un DataRow único

   En el código siguiente se muestra cómo agregar un nuevo registro a DataTable y, a continuación, llamar al TableAdapter.Update método para guardar la nueva fila en la base de datos. En este ejemplo se usa la Region tabla de la base de datos Northwind.

   • C#
   • VB

   // Create a new row.
   NorthwindDataSet.RegionRow newRegionRow;
   newRegionRow = northwindDataSet.Region.NewRegionRow();
   newRegionRow.RegionID = 5;
   newRegionRow.RegionDescription = "NorthWestern";
   
   // Add the row to the Region table
   this.northwindDataSet.Region.Rows.Add(newRegionRow);
   
   // Save the new row to the database
   this.regionTableAdapter.Update(this.northwindDataSet.Region);
   

Insertar nuevos registros con el método TableAdapter.Insert

Si la aplicación usa objetos para almacenar datos, puede usar el TableAdapter.Insert método para crear filas nuevas directamente en la base de datos. El Insert método acepta los valores individuales de cada columna como parámetros. Al llamar al método , se inserta un nuevo registro en la base de datos con los valores de parámetro pasados.

• Llame al método tableAdapter Insert y pase los valores de cada columna como parámetros.

En el procedimiento siguiente se muestra cómo usar el TableAdapter.Insert método para insertar filas. En este ejemplo se insertan datos en la Region tabla de la base de datos Northwind.

NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Insert(5, "NorthWestern");

Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Insert(5, "NorthWestern")

Insertar nuevos registros con objetos de comando

Puede insertar registros nuevos directamente en una base de datos mediante objetos de comando.

• Cree un nuevo objeto de comando y, a continuación, establezca sus Connectionpropiedades , CommandTypey CommandText .

En el procedimiento siguiente se muestra cómo insertar registros en una base de datos mediante el uso de un objeto de comando. En este ejemplo se insertan datos en la Region tabla de la base de datos Northwind.

System.Data.SqlClient.SqlConnection sqlConnection1 = 
    new System.Data.SqlClient.SqlConnection("YOUR CONNECTION STRING");

System.Data.SqlClient.SqlCommand cmd = new System.Data.SqlClient.SqlCommand();
cmd.CommandType = System.Data.CommandType.Text;
cmd.CommandText = "INSERT Region (RegionID, RegionDescription) VALUES (5, 'NorthWestern')";
cmd.Connection = sqlConnection1;

sqlConnection1.Open();
cmd.ExecuteNonQuery();
sqlConnection1.Close();

Dim sqlConnection1 As New System.Data.SqlClient.SqlConnection("YOUR CONNECTION STRING")

Dim cmd As New System.Data.SqlClient.SqlCommand
cmd.CommandType = System.Data.CommandType.Text
cmd.CommandText = "INSERT Region (RegionID, RegionDescription) VALUES (5, 'NorthWestern')"
cmd.Connection = sqlConnection1

sqlConnection1.Open()
cmd.ExecuteNonQuery()
sqlConnection1.Close()

Contenido relacionado

• Guardar los datos en la base de datos
• Guardar datos con los métodos DBDirect de TableAdapter en aplicaciones de .NET Framework