Insertar nuevos registros en una base de datosInsert new records into a database

Para insertar nuevos registros en una base de datos, puede usar el TableAdapter.Update método, o a uno de los métodos DBDirect del TableAdapter (específicamente el TableAdapter.Insert método).To insert new records into a database, you can use the TableAdapter.Update method, or one of the TableAdapter's DBDirect methods (specifically the TableAdapter.Insert method). Para obtener más información, consulte TableAdapter.For more information, see TableAdapter.

Si su aplicación no utiliza TableAdapters, puede utilizar objetos de comando (por ejemplo, SqlCommand) para insertar nuevos registros en la base de datos.If your application doesn't use TableAdapters, you can use command objects (for example, SqlCommand) to insert new records in your database.

Si la aplicación usa conjuntos de datos para almacenar los datos, use la TableAdapter.Update método.If your application uses datasets to store data, use the TableAdapter.Update method. El Update método envía todos los cambios (actualizaciones, inserciones y eliminaciones) a la base de datos.The Update method sends all changes (updates, inserts, and deletes) to the database.

Si su aplicación utiliza objetos para almacenar datos, o si desea un mayor control sobre la creación de nuevos registros en la base de datos, use la TableAdapter.Insert método.If your application uses objects to store data, or if you want finer control over creating new records in the database, use the TableAdapter.Insert method.

Si el TableAdapter no dispone de un Insert (método), significa que el TableAdapter está configurado para utilizar procedimientos almacenados o su GenerateDBDirectMethods propiedad está establecida en false.If your TableAdapter doesn't have an Insert method, it means that either the TableAdapter is configured to use stored procedures or its GenerateDBDirectMethods property is set to false. Intente establecer el TableAdapter GenerateDBDirectMethods propiedad true desde el Diseñador de Datasety, a continuación, guarde el conjunto de datos.Try setting the TableAdapter's GenerateDBDirectMethods property to true from within the Dataset Designer, and then save the dataset. Se volverá a generar el TableAdapter.This will regenerate the TableAdapter. Si el TableAdapter no tiene todavía un Insert método y, a continuación, en la tabla probablemente no proporciona suficiente información de esquema para distinguir entre filas individuales (por ejemplo, no podría haber ningún conjunto de clave principal en la tabla).If the TableAdapter still doesn't have an Insert method, then the table probably does not provide enough schema information to distinguish between individual rows (for example, there might be no primary key set on the table).

Insertar nuevos registros mediante TableAdaptersInsert new records by using TableAdapters

Los TableAdapters proporcionan maneras diferentes de insertar nuevos registros en una base de datos, dependiendo de los requisitos de la aplicación.TableAdapters provide different ways to insert new records into a database, depending on the requirements of your application.

Si la aplicación usa conjuntos de datos para almacenar datos, simplemente puede agregar nuevos registros a lo que se desea DataTable en el conjunto de datos y, a continuación, llame el TableAdapter.Update método.If your application uses datasets to store data, then you can simply add new records to the desired DataTable in the dataset, and then call the TableAdapter.Update method. El TableAdapter.Update método envía los cambios la DataTable a la base de datos (incluidos los registros modificados y eliminados).The TableAdapter.Update method sends any changes in the DataTable to the database (including modified and deleted records).

Para insertar nuevos registros en una base de datos mediante el método TableAdapter.UpdateTo insert new records into a database by using the TableAdapter.Update method

  1. Agregar nuevos registros a lo que se desea DataTable al crear un nuevo DataRow y agregarla a la Rows colección.Add new records to the desired DataTable by creating a new DataRow and adding it to the Rows collection.

  2. Después de que las nuevas filas se agregan a la DataTable, llame a la TableAdapter.Update método.After the new rows are added to the DataTable, call the TableAdapter.Update method. Puede controlar la cantidad de datos que se va a actualizar pasando toda una DataSet, DataTable, una matriz de DataRows o un único DataRow.You can control the amount of data to update by passing in either an entire DataSet, a DataTable, an array of DataRows, or a single DataRow.

    El código siguiente muestra cómo agregar un nuevo registro para un DataTable y, a continuación, llame a la TableAdapter.Update método para guardar la nueva fila en la base de datos.The following code shows how to add a new record to a DataTable and then call the TableAdapter.Update method to save the new row to the database. (Este ejemplo se utiliza la Region tabla en la base de datos Northwind.)(This example uses the Region table in the Northwind database.)

    ' Create a new row.
    Dim newRegionRow As NorthwindDataSet.RegionRow
    newRegionRow = Me.NorthwindDataSet._Region.NewRegionRow()
    newRegionRow.RegionID = 5
    newRegionRow.RegionDescription = "NorthWestern"
    
    ' Add the row to the Region table
    Me.NorthwindDataSet._Region.Rows.Add(newRegionRow)
    
    ' Save the new row to the database
    Me.RegionTableAdapter.Update(Me.NorthwindDataSet._Region)
    
    // 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);
    

Para insertar nuevos registros en una base de datos mediante el método TableAdapter.InsertTo insert new records into a database by using the TableAdapter.Insert method

Si la aplicación utiliza objetos para almacenar los datos, puede usar el TableAdapter.Insert método para crear nuevas filas directamente en la base de datos.If your application uses objects to store data, you can use the TableAdapter.Insert method to create new rows directly in the database. El Insert método acepta los valores individuales de cada columna como parámetros.The Insert method accepts the individual values for each column as parameters. Una llamada al método, inserta un nuevo registro en la base de datos con los valores de parámetro pasados.Calling the method inserts a new record into the database with the parameter values passed in.

  • Llamar a del TableAdapter Insert método, pasando los valores de cada columna como parámetros.Call the TableAdapter's Insert method, passing in the values for each column as parameters.

    El siguiente procedimiento muestra cómo utilizar el TableAdapter.Insert método para insertar filas.The following procedure demonstrates using the TableAdapter.Insert method to insert rows. En este ejemplo se inserta datos en el Region tabla en la base de datos Northwind.This example inserts data into the Region table in the Northwind database.

    Nota

    Si no tiene una instancia disponible, cree una instancia del TableAdapter que desea usar.If you do not have an instance available, instantiate the TableAdapter you want to use.

    Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter
    
    regionTableAdapter.Insert(5, "NorthWestern")
    
    NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
        new NorthwindDataSetTableAdapters.RegionTableAdapter();
    
    regionTableAdapter.Insert(5, "NorthWestern");
    

Insertar nuevos registros mediante objetos de comandoInsert new records by using command objects

Puede insertar nuevos registros directamente en una base de datos mediante objetos de comando.You can insert new records directly into a database using command objects.

Para insertar nuevos registros en una base de datos mediante objetos de comandoTo insert new records into a database by using command objects

  • Crear un nuevo objeto de comando y, a continuación, establezca su Connection, CommandType, y CommandText propiedades.Create a new command object, and then set its Connection, CommandType, and CommandText properties.

    El ejemplo siguiente muestra la inserción de registros en una base de datos con objeto de comando.The following example demonstrates inserting records into a database using command object. Inserta datos en el Region tabla en la base de datos Northwind.It inserts data into the Region table in the Northwind database.

    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()
    
    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();
    

Seguridad de .NET Framework.NET Framework Security

Debe tener acceso a la base de datos a que está intentando conectarse, así como permiso para realizar inserciones en la tabla deseada.You must have access to the database you are trying to connect to, as well as permission to perform inserts into the desired table.

Vea tambiénSee also