SqlDataAdapter Clase

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

Representa un conjunto de comandos de datos y una conexión a una base de datos que se usan para rellenar DataSet y actualizar una base de datos de SQL Server. Esta clase no puede heredarse.

public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type SqlDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Herencia

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Implementaciones

IDataAdapter IDbDataAdapter ICloneable

Ejemplos

En el ejemplo siguiente se usa , SqlCommandSqlDataAdaptery SqlConnection para seleccionar registros de una base de datos y rellenar con DataSet las filas seleccionadas. A continuación, se devuelve el relleno DataSet . Para ello, el método se pasa un inicializado DataSet, un cadena de conexión y una cadena de consulta que es una instrucción SELECT de Transact-SQL.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Comentarios

SqlDataAdapter, actúa como un puente entre un DataSet y SQL Server para recuperar y guardar datos. SqlDataAdapter proporciona este puente mediante la asignación Fillde , que cambia los datos de DataSet para que coincidan con los datos del origen de datos y Update, que cambia los datos del origen de datos para que coincidan con los datos de DataSet, utilizando las instrucciones Transact-SQL adecuadas en el origen de datos. La actualización se realiza por fila. Para cada fila insertada, modificada y eliminada, el Update método determina el tipo de cambio que se ha realizado en él (Insert, Updateo Delete). Según el tipo de cambio, la Insertplantilla de comando , Updateo Delete se ejecuta para propagar la fila modificada al origen de datos. SqlDataAdapter Cuando rellena un DataSetobjeto , crea las tablas y columnas necesarias para los datos devueltos si aún no existen. Sin embargo, la información de clave principal no se incluye en el esquema creado implícitamente a menos que la MissingSchemaAction propiedad esté establecida AddWithKeyen . También puede tener el SqlDataAdapter esquema de creación de , incluida la información de DataSetclave principal, antes de rellenarlo con datos mediante FillSchema. Para obtener más información, vea Agregar restricciones existentes a un conjunto de datos.

SqlDataAdapterse usa junto con SqlConnection y SqlCommand para aumentar el rendimiento al conectarse a una base de datos de SQL Server.

Nota

Si está utilizando procedimientos almacenados de SQL Server para editar o eliminar datos con DataAdapter, asegúrese de que no utiliza SET NOCOUNT ON en la definición del procedimiento almacenado. Esto hace que el recuento de filas afectadas vuelva a cero, lo que DataAdapter interpreta como un conflicto de simultaneidad. En este caso, se iniciará una DBConcurrencyException.

También SqlDataAdapter incluye las SelectCommandpropiedades , , DeleteCommandInsertCommand, UpdateCommandy TableMappings para facilitar la carga y actualización de datos.

Cuando se crea una instancia de , las propiedades de SqlDataAdapter lectura y escritura se establecen en valores iniciales. Para obtener una lista de estos valores, consulte el SqlDataAdapter constructor .

Las InsertCommandplantillas , DeleteCommandy UpdateCommand son plantillas genéricas que se rellenan automáticamente con valores individuales de cada fila modificada a través del mecanismo de parámetros.

Para cada columna que se propaga al origen de datos en Update, se debe agregar un parámetro a InsertCommand, UpdateCommando DeleteCommand. La SourceColumn propiedad del DbParameter objeto debe establecerse en el nombre de la columna. Esta configuración indica que el valor del parámetro no se establece manualmente, pero se toma de la columna concreta de la fila procesada actualmente.

Nota

Se InvalidOperationException producirá si se llama al Fill método y la tabla contiene un tipo definido por el usuario que no está disponible en el equipo cliente. Para obtener más información, vea Tipos definidos por el usuario de CLR.

Constructores

SqlDataAdapter()	Inicializa una nueva instancia de la clase SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Inicializa una nueva instancia de la clase SqlDataAdapter con el objeto SqlCommand especificado como propiedad SelectCommand.
SqlDataAdapter(String, SqlConnection)	Inicializa una nueva instancia de la clase SqlDataAdapter con una propiedad SelectCommand y un objeto SqlConnection.
SqlDataAdapter(String, String)	Inicializa una nueva instancia de la clase SqlDataAdapter con una propiedad SelectCommand y una cadena de conexión.

Campos

DefaultSourceTableName

Nombre predeterminado que el objeto DataAdapter utiliza para las asignaciones de tabla. (Heredado de DbDataAdapter)

Propiedades

AcceptChangesDuringFill	Obtiene o establece un valor que indica si se llama a AcceptChanges() en un elemento DataRow después de agregarlo a DataTable durante cualquiera de las operaciones Fill. (Heredado de DataAdapter)
AcceptChangesDuringUpdate	Obtiene o establece si se llama a AcceptChanges() durante una operación Update(DataSet). (Heredado de DataAdapter)
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
ContinueUpdateOnError	Obtiene o establece un valor que especifica si debe generarse una excepción cuando se produce un error durante una actualización de fila. (Heredado de DataAdapter)
DeleteCommand	Obtiene o establece un procedimiento almacenado o una instrucción de Transact-SQL para eliminar registros de un conjunto de datos.
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
FillCommandBehavior	Obtiene o establece el comportamiento del comando utilizado para rellenar el adaptador de datos. (Heredado de DbDataAdapter)
FillLoadOption	Obtiene o establece el valor de LoadOption que determina cómo rellena el adaptador el objeto DataTable a partir de DbDataReader. (Heredado de DataAdapter)
InsertCommand	Obtiene o establece un procedimiento almacenado o una instrucción de Transact-SQL para insertar nuevos registros en el origen de datos.
MissingMappingAction	Determina la acción que hay que llevar a cabo si los datos entrantes no tienen una tabla o una columna coincidente. (Heredado de DataAdapter)
MissingSchemaAction	Determina la acción que hay que llevar a cabo cuando el esquema DataSet existente no coincide con los datos entrantes. (Heredado de DataAdapter)
ReturnProviderSpecificTypes	Obtiene o establece un valor que indica si el método Fill debe devolver valores específicos del proveedor o valores comunes conforme a CLS. (Heredado de DataAdapter)
SelectCommand	Obtiene o establece un procedimiento almacenado o una instrucción de Transact-SQL para seleccionar registros en el origen de datos.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
TableMappings	Obtiene una colección que proporciona la asignación principal entre una tabla de origen y .DataTable (Heredado de DataAdapter)
UpdateBatchSize	Obtiene o establece el número de filas procesadas en cada acción de ida y vuelta al servidor.
UpdateCommand	Obtiene o establece un procedimiento almacenado o una instrucción de Transact-SQL para actualizar los registros del origen de datos.

Métodos

AddToBatch(IDbCommand)	Agrega una interfaz IDbCommand al lote actual. (Heredado de DbDataAdapter)
ClearBatch()	Quita todos los objetos IDbCommand del lote. (Heredado de DbDataAdapter)
CloneInternals()	Obsoletos. Crea una copia de esta instancia de DataAdapter. (Heredado de DataAdapter)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializa una nueva instancia de la clase RowUpdatedEventArgs. (Heredado de DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializa una nueva instancia de la clase RowUpdatingEventArgs. (Heredado de DbDataAdapter)
CreateTableMappings()	Crea un nuevo DataTableMappingCollection. (Heredado de DataAdapter)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa DbDataAdapter y, de forma opcional, libera los recursos administrados. (Heredado de DbDataAdapter)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExecuteBatch()	Ejecuta el lote actual. (Heredado de DbDataAdapter)
Fill(DataSet)	Agrega o actualiza filas en DataSet. (Heredado de DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y DataTable. (Heredado de DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y los nombres de tabla de origen, la cadena de comando y el comportamiento de comando. (Heredado de DbDataAdapter)
Fill(DataSet, String)	Agrega filas a DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y DataTable. (Heredado de DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)	Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet, DataTable y IDataReader. (Heredado de DbDataAdapter)
Fill(DataTable)	Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando el nombre de DataTable. (Heredado de DbDataAdapter)
Fill(DataTable, IDataReader)	Agrega filas a un objeto DataTable o las actualiza para hacerlas coincidir con las del origen de datos, utilizando los nombres de DataTable y IDataReader especificados. (Heredado de DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Agrega filas a un objeto DataTable o las actualiza para hacerlas coincidir con las del origen de datos, utilizando los objetos DataTable, IDbCommand y CommandBehavior especificados. (Heredado de DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Agrega filas en un intervalo especificado de la colección de objetos DataTable o las actualiza para hacerlas coincidir con las filas del origen de datos. (Heredado de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y DataTable. (Heredado de DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Agrega o actualiza filas en uno o varios DataTable objetos para que coincidan con los del origen de datos a partir del registro especificado y recuperando hasta el número máximo de registros especificado. (Heredado de DbDataAdapter)
FillSchema(DataSet, SchemaType)	Agrega una DataTable denominada "Table" para el DataSet especificado y configura el esquema para que coincida con el origen de datos basado en el SchemaType especificado. (Heredado de DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Agrega un elemento DataTable denominado "Table" para el elemento DataSet especificado y configura el esquema para que coincida con el origen de datos basado en el SchemaType. (Heredado de DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	Agrega un elemento DataTable denominado "Table" para el elemento DataSet especificado y configura el esquema para que coincida con el del origen de datos basado en los elementos especificados SchemaType y DataTable. (Heredado de DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Agrega un objeto DataTable al objeto DataSet especificado. (Heredado de DataAdapter)
FillSchema(DataTable, SchemaType)	Configura el esquema del elemento DataTable especificado en función del elemento SchemaType especificado. (Heredado de DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Agrega un objeto DataTable al objeto DataSet especificado. (Heredado de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configura el esquema de la tabla DataTable especificada en función del SchemaType, la cadena de comando y los valores de CommandBehavior especificados. (Heredado de DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Devuelve una interfaz IDataParameter de uno de los comandos del lote actual. (Heredado de DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Devuelve información sobre un intento de actualización dentro de una actualización más amplia por lotes. (Heredado de DbDataAdapter)
GetFillParameters()	Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL. (Heredado de DbDataAdapter)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HasTableMappings()	Indica si se ha creado una colección DataTableMappingCollection. (Heredado de DataAdapter)
InitializeBatching()	Inicializa el procesamiento por lotes de DbDataAdapter. (Heredado de DbDataAdapter)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Genera el evento FillError. (Heredado de DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Provoca el evento RowUpdated de un proveedor de datos de .NET. (Heredado de DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Provoca el evento RowUpdating de un proveedor de datos de .NET. (Heredado de DbDataAdapter)
ResetFillLoadOption()	Restablece FillLoadOption a su estado predeterminado y hace que Fill(DataSet) tenga en cuenta AcceptChangesDuringFill. (Heredado de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Determina si la propiedad AcceptChangesDuringFill debe persistir. (Heredado de DataAdapter)
ShouldSerializeFillLoadOption()	Determina si la propiedad FillLoadOption debe persistir. (Heredado de DataAdapter)
ShouldSerializeTableMappings()	Determina si uno o más objetos DataTableMapping existen y si deben almacenarse. (Heredado de DataAdapter)
TerminateBatching()	Finaliza el procesamiento por lotes para DbDataAdapter. (Heredado de DbDataAdapter)
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)
Update(DataRow[])	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz especificada en DataSet. (Heredado de DbDataAdapter)
Update(DataRow[], DataTableMapping)	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz de objetos DataRow especificada. (Heredado de DbDataAdapter)
Update(DataSet)	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet especificados. (Heredado de DbDataAdapter)
Update(DataSet, String)	Actualiza los valores de la base de datos al ejecutar las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet con el nombre de DataTable especificado. (Heredado de DbDataAdapter)
Update(DataTable)	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataTable especificados. (Heredado de DbDataAdapter)

Eventos

Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)
FillError	Se devuelve cuando se produce un error durante una operación de relleno. (Heredado de DbDataAdapter)
RowUpdated	Se produce durante Update(DataSet) después de que se ejecute un comando en el origen de datos. Se ha realizado un intento de actualización, de manera que se inicia el evento.
RowUpdating	Se produce durante el método Update(DataSet), antes de que se ejecute un comando en el origen de datos. Se ha realizado un intento de actualización, de manera que se inicia el evento.

Implementaciones de interfaz explícitas

ICloneable.Clone()	Para obtener una descripción de este miembro, vea Clone().
IDataAdapter.TableMappings	Obtiene una colección que indica cómo se asigna una tabla de origen a una tabla de conjunto de datos. (Heredado de DataAdapter)
IDbDataAdapter.DeleteCommand	Para obtener una descripción de este miembro, vea DeleteCommand.
IDbDataAdapter.InsertCommand	Para obtener una descripción de este miembro, vea InsertCommand.
IDbDataAdapter.SelectCommand	Para obtener una descripción de este miembro, vea SelectCommand.
IDbDataAdapter.UpdateCommand	Para obtener una descripción de este miembro, vea UpdateCommand.

Consulte también

• Objetos DataAdapter y DataReader
• Manipular datos (ADO.NET)
• Información general de ADO.NET