Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota:
La DataSet clase y las clases relacionadas son tecnologías heredadas de .NET Framework de principios de los años 2000 que permiten a las aplicaciones trabajar con datos en memoria mientras las aplicaciones están desconectadas de la base de datos. Las tecnologías son especialmente útiles para las aplicaciones que permiten a los usuarios modificar datos y conservar los cambios de nuevo en la base de datos. Aunque los conjuntos de datos son una tecnología probada de éxito, el enfoque recomendado para las nuevas aplicaciones .NET es usar Entity Framework Core. Entity Framework proporciona una manera más natural de trabajar con datos tabulares como modelos de objetos y tiene una interfaz de programación más sencilla.
Puede guardar datos en objetos en una base de datos pasando los valores del objeto a uno de los métodos DBDirect de TableAdapter (por ejemplo, TableAdapter.Insert). Para obtener más información, vea TableAdapter.
Para guardar datos de una colección de objetos, recorra en bucle la colección de objetos (por ejemplo, un bucle for-next) y envíe los valores de cada objeto a la base de datos mediante uno de los métodos de DBDirect TableAdapter.
De forma predeterminada, DBDirect los métodos se crean en un TableAdapter que se puede ejecutar directamente en la base de datos. Estos métodos se pueden llamar directamente y no requieren DataSet objetos o DataTable para conciliar los cambios con el fin de enviar actualizaciones a una base de datos.
Nota:
Al configurar un TableAdapter, la consulta principal debe proporcionar suficiente información para que se creen los DBDirect métodos. Por ejemplo, si un TableAdapter está configurado para consultar datos de una tabla que no tiene definida una columna de clave principal, no genera DBDirect métodos.
| Método DBDirect de TableAdapter | Descripción |
|---|---|
TableAdapter.Insert |
Agrega nuevos registros a una base de datos y permite pasar valores de columna individuales como parámetros de método. |
TableAdapter.Update |
Actualiza los registros existentes en una base de datos. El Update método toma valores de columna originales y nuevos como parámetros de método. Los valores originales se usan para localizar el registro original y los nuevos valores se usan para actualizar ese registro.El método TableAdapter.Update también se usa para conciliar los cambios en un conjunto de datos de vuelta a la base de datos tomando como parámetros un DataSet, DataTable, DataRow o una matriz de DataRow. |
TableAdapter.Delete |
Elimina los registros existentes de la base de datos en función de los valores de columna originales pasados como parámetros de método. |
Para guardar registros nuevos de un objeto en una base de datos
Cree los registros pasando los valores al
TableAdapter.Insertmétodo .En el ejemplo siguiente se crea un nuevo registro de cliente en la
Customerstabla pasando los valores delcurrentCustomerobjeto alTableAdapter.Insertmétodo .private void AddNewCustomers(Customer currentCustomer) { customersTableAdapter.Insert( currentCustomer.CustomerID, currentCustomer.CompanyName, currentCustomer.ContactName, currentCustomer.ContactTitle, currentCustomer.Address, currentCustomer.City, currentCustomer.Region, currentCustomer.PostalCode, currentCustomer.Country, currentCustomer.Phone, currentCustomer.Fax); }
Para actualizar los registros existentes de un objeto a una base de datos
Modifique los registros llamando al
TableAdapter.Updatemétodo , pasando los nuevos valores para actualizar el registro y pasando los valores originales para localizar el registro.Nota:
El objeto debe mantener los valores originales para pasarlos al
Updatemétodo . En este ejemplo se usan propiedades con unorigprefijo para almacenar los valores originales.En el ejemplo siguiente se actualiza un registro existente en la
Customerstabla pasando los valores nuevos y originales delCustomerobjeto alTableAdapter.Updatemétodo .private void UpdateCustomer(Customer cust) { customersTableAdapter.Update( cust.CustomerID, cust.CompanyName, cust.ContactName, cust.ContactTitle, cust.Address, cust.City, cust.Region, cust.PostalCode, cust.Country, cust.Phone, cust.Fax, cust.origCustomerID, cust.origCompanyName, cust.origContactName, cust.origContactTitle, cust.origAddress, cust.origCity, cust.origRegion, cust.origPostalCode, cust.origCountry, cust.origPhone, cust.origFax); }
Para eliminar registros existentes de una base de datos
Elimine los registros llamando al
TableAdapter.Deletemétodo y pasando los valores originales para localizar el registro.Nota:
El objeto debe mantener los valores originales para pasarlos al
Deletemétodo . En este ejemplo se usan propiedades con unorigprefijo para almacenar los valores originales.En el ejemplo siguiente se elimina un registro de la
Customerstabla pasando los valores originales delCustomerobjeto alTableAdapter.Deletemétodo .
Seguridad de .NET
Debe tener permiso para realizar la operación INSERT, UPDATE o DELETE seleccionada en la tabla de la base de datos.