Compartir a través de


Clase SqlCeDataAdapter

Representa un conjunto de comandos de datos y una conexión de base de datos que se utilizan para rellenar DataSet y actualizar el origen de datos.

Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DataAdapter
        System.Data.Common.DbDataAdapter
          System.Data.SqlServerCe.SqlCeDataAdapter

Espacio de nombres:  System.Data.SqlServerCe
Ensamblado:  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
Public NotInheritable Class SqlCeDataAdapter _
    Inherits DbDataAdapter _
    Implements ICloneable
'Uso
Dim instance As SqlCeDataAdapter
public sealed class SqlCeDataAdapter : DbDataAdapter, 
    ICloneable
public ref class SqlCeDataAdapter sealed : public DbDataAdapter, 
    ICloneable
[<SealedAttribute>]
type SqlCeDataAdapter =  
    class
        inherit DbDataAdapter
        interface ICloneable
    end
public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

El tipo SqlCeDataAdapter expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público SqlCeDataAdapter() Inicializa una nueva instancia de la clase SqlCeDataAdapter.
Método público SqlCeDataAdapter(SqlCeCommand) Inicializa una nueva instancia de la clase SqlCeDataAdapter con el objeto SqlCeCommand especificado como propiedad SelectCommand.
Método público SqlCeDataAdapter(String, SqlCeConnection) Inicializa una nueva instancia de la clase SqlCeDataAdapter con SelectCommand y un objeto SqlCeConnection.
Método público SqlCeDataAdapter(String, String) Inicializa una nueva instancia de la clase SqlCeDataAdapter con SelectCommand y una cadena de conexión.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública AcceptChangesDuringFill (se hereda de DataAdapter)
Propiedad pública AcceptChangesDuringUpdate (se hereda de DataAdapter)
Propiedad protegida CanRaiseEvents (se hereda de Component)
Propiedad pública Container (se hereda de Component)
Propiedad pública ContinueUpdateOnError (se hereda de DataAdapter)
Propiedad pública DeleteCommand Obtiene o establece una instrucción SQL para eliminar registros del conjunto de datos.
Propiedad protegida DesignMode (se hereda de Component)
Propiedad protegida Events (se hereda de Component)
Propiedad protegida FillCommandBehavior (se hereda de DbDataAdapter)
Propiedad pública FillLoadOption (se hereda de DataAdapter)
Propiedad pública InsertCommand Obtiene o establece una instrucción SQL utilizada para insertar nuevos registros en el origen de datos.
Propiedad pública MissingMappingAction (se hereda de DataAdapter)
Propiedad pública MissingSchemaAction (se hereda de DataAdapter)
Propiedad pública ReturnProviderSpecificTypes (se hereda de DataAdapter)
Propiedad pública SelectCommand Obtiene o establece una instrucción SQL utilizada para seleccionar registros en el origen de datos.
Propiedad pública Site (se hereda de Component)
Propiedad pública TableMappings (se hereda de DataAdapter)
Propiedad pública UpdateBatchSize (se hereda de DbDataAdapter)
Propiedad pública UpdateCommand Obtiene o establece una instrucción SQL utilizada para actualizar registros en el origen de datos.

Arriba

Métodos

  Nombre Descripción
Método protegido AddToBatch (se hereda de DbDataAdapter)
Método protegido ClearBatch (se hereda de DbDataAdapter)
Método protegido CloneInternals Obsoleto. (se hereda de DataAdapter)
Método público CreateObjRef (se hereda de MarshalByRefObject)
Método protegido CreateRowUpdatedEvent (se hereda de DbDataAdapter)
Método protegido CreateRowUpdatingEvent (se hereda de DbDataAdapter)
Método protegido CreateTableMappings (se hereda de DataAdapter)
Método público Dispose() Elimina la instancia actual.
Método protegido Dispose(Boolean) (se hereda de DbDataAdapter)
Método público Equals (se hereda de Object)
Método protegido ExecuteBatch (se hereda de DbDataAdapter)
Método público Fill(DataSet) (se hereda de DbDataAdapter)
Método público Fill(DataTable) (se hereda de DbDataAdapter)
Método público Fill(DataSet, String) (se hereda de DbDataAdapter)
Método protegido Fill(DataTable, IDataReader) (se hereda de DataAdapter)
Método público Fill(Int32, Int32, array<DataTable[]) (se hereda de DbDataAdapter)
Método protegido Fill(DataTable, IDbCommand, CommandBehavior) (se hereda de DbDataAdapter)
Método público Fill(DataSet, Int32, Int32, String) (se hereda de DbDataAdapter)
Método protegido Fill(array<DataTable[], IDataReader, Int32, Int32) (se hereda de DataAdapter)
Método protegido Fill(array<DataTable[], Int32, Int32, IDbCommand, CommandBehavior) (se hereda de DbDataAdapter)
Método protegido Fill(DataSet, String, IDataReader, Int32, Int32) (se hereda de DataAdapter)
Método protegido Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) (se hereda de DbDataAdapter)
Método público FillSchema(DataTable, SchemaType) (se hereda de DbDataAdapter)
Método público FillSchema(DataSet, SchemaType) (se hereda de DbDataAdapter)
Método público FillSchema(DataSet, SchemaType, String) (se hereda de DbDataAdapter)
Método protegido FillSchema(DataTable, SchemaType, IDataReader) (se hereda de DataAdapter)
Método protegido FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) (se hereda de DbDataAdapter)
Método protegido FillSchema(DataSet, SchemaType, String, IDataReader) (se hereda de DataAdapter)
Método protegido FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) (se hereda de DbDataAdapter)
Método protegido Finalize (se hereda de Component)
Método protegido GetBatchedParameter (se hereda de DbDataAdapter)
Método protegido GetBatchedRecordsAffected (se hereda de DbDataAdapter)
Método público GetFillParameters (se hereda de DbDataAdapter)
Método público GetHashCode (se hereda de Object)
Método público GetLifetimeService (se hereda de MarshalByRefObject)
Método protegido GetService (se hereda de Component)
Método público GetType (se hereda de Object)
Método protegido HasTableMappings (se hereda de DataAdapter)
Método protegido InitializeBatching (se hereda de DbDataAdapter)
Método público InitializeLifetimeService (se hereda de MarshalByRefObject)
Método protegido MemberwiseClone() (se hereda de Object)
Método protegido MemberwiseClone(Boolean) (se hereda de MarshalByRefObject)
Método protegido OnFillError (se hereda de DataAdapter)
Método protegido OnRowUpdated (se hereda de DbDataAdapter)
Método protegido OnRowUpdating (se hereda de DbDataAdapter)
Método público ResetFillLoadOption (se hereda de DataAdapter)
Método público ShouldSerializeAcceptChangesDuringFill (se hereda de DataAdapter)
Método público ShouldSerializeFillLoadOption (se hereda de DataAdapter)
Método protegido ShouldSerializeTableMappings (se hereda de DataAdapter)
Método protegido TerminateBatching (se hereda de DbDataAdapter)
Método público ToString (se hereda de Component)
Método público Update(DataSet) (se hereda de DbDataAdapter)
Método público Update(array<DataRow[]) (se hereda de DbDataAdapter)
Método público Update(DataTable) (se hereda de DbDataAdapter)
Método público Update(DataSet, String) (se hereda de DbDataAdapter)
Método protegido Update(array<DataRow[], DataTableMapping) (se hereda de DbDataAdapter)

Arriba

Eventos

  Nombre Descripción
Evento público Disposed (se hereda de Component)
Evento público FillError (se hereda de DataAdapter)
Evento público RowUpdated Aparece durante una llamada a Update después de que se ejecute un comando de actualización en el origen de datos. Se hace un intento de actualización y, a continuación, se inicia el evento.
Evento público RowUpdating Aparece durante una llamada a Update antes de que se ejecute un comando de actualización en el origen de datos. Se hace un intento de actualización y, a continuación, se inicia el evento.

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado ICloneable.Clone Para obtener una descripción de este miembro, vea ICloneable.Clone().
Implementación de interfaces explícitasPropiedad privada IDbDataAdapter.DeleteCommand (se hereda de DbDataAdapter)
Implementación de interfaces explícitasPropiedad privada IDbDataAdapter.InsertCommand (se hereda de DbDataAdapter)
Implementación de interfaces explícitasPropiedad privada IDbDataAdapter.SelectCommand (se hereda de DbDataAdapter)
Implementación de interfaces explícitasPropiedad privada IDataAdapter.TableMappings (se hereda de DataAdapter)
Implementación de interfaces explícitasPropiedad privada IDbDataAdapter.UpdateCommand (se hereda de DbDataAdapter)

Arriba

Comentarios

La clase SqlCeDataAdapter actúa como puente entre una clase DataSet y el origen de datos. Se utiliza para recuperar datos del origen de datos y para guardar datos en él. La clase SqlCeDataAdapter proporciona este puente utilizando el método Fill para cargar datos del origen de datos en la clase DataSet, así como el método Update para devolver los cambios realizados en la clase DataSet al origen de datos.

Cuando SqlCeDataAdapter rellene un objeto DataSet, creará las tablas y columnas necesarias para los datos devueltos si todavía no existen. Sin embargo, la información de clave principal no se incluirá en el esquema creado implícitamente a menos que la propiedad MissingSchemaAction esté establecida en AddWithKey. La clase SqlCeDataAdapter también puede crear el esquema de la clase DataSet, incluida la información de clave principal, antes de rellenarla de datos mediante FillSchema.

La clase SqlCeDataAdapter contiene las propiedades SelectCommand, InsertCommand, DeleteCommand, UpdateCommand y TableMappings para facilitar la carga y la actualización de los datos.

Cuando se crea una instancia de SqlCeDataAdapter, se establecen las propiedades en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor de SqlCeDataAdapter.

Ejemplos

En el ejemplo siguiente, se utiliza el objeto SqlCeCommand, la SqlCeDataAdapter y SqlCeConnection para seleccionar registros de un origen de datos y rellenar una clase DataSet con las filas seleccionadas. A continuación, se devuelve la clase DataSet rellena. Para realizar esta operación, se pasa al método un objeto DataSet inicializado, una cadena de conexión y una cadena de consulta que es una instrucción SELECT de SQL.

Try
    Dim strDataSource As String
    strDataSource = "" & _
        "Data Source = C:\Program Files\" & _
        "Microsoft SQL Server Compact Edition\v3.5\Samples\" & _
        "Northwind.sdf"
    Dim conn As New SqlCeConnection
    conn.ConnectionString = strDataSource & ";Password='<password>'"

    Dim selectCmd As SqlCeCommand = conn.CreateCommand
    selectCmd.CommandText = "SELECT * FROM Employees"

    Dim adp As New SqlCeDataAdapter(selectCmd)

    Dim ds As New DataSet

    ' Note: Fill will leave the connection in its original state;
    ' In this case, the connection was closed so it will be left closed
    adp.Fill(ds)

    Console.WriteLine(("The SqlCeDataAdapter succesfully filled " & _
                       ds.Tables.Item(0).Rows.Count & " rows in the DataSet!"))
Catch ds As Exception
    Console.WriteLine(ds.Message)
Finally
    Console.WriteLine(vbNewLine & vbNewLine & vbNewLine & _
                      "Press any key to continue...")
    Console.ReadKey()
End Try
try
{
    string strDataSource =
        @"Data Source = C:\Program Files\" +
        @"Microsoft SQL Server Compact Edition\v3.5\Samples\" +
        @"Northwind.sdf";
    SqlCeConnection conn = new SqlCeConnection();
    conn.ConnectionString = strDataSource + ";Password='<password>'";

    SqlCeCommand selectCmd = conn.CreateCommand();
    selectCmd.CommandText = "SELECT * FROM Employees";

    SqlCeDataAdapter adp = new SqlCeDataAdapter(selectCmd);

    DataSet ds = new DataSet();

    // Note: Fill will leave the connection in its original state;
    // In this case, the connection was closed so it will be left closed
    //
    adp.Fill(ds);

    Console.WriteLine("The SqlCeDataAdapter succesfully filled " +
        ds.Tables[0].Rows.Count + " rows in the DataSet!");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}
finally
{
    Console.WriteLine("\n\n\nPress any key to continue...");
    Console.ReadKey();
}

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared in Microsoft Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres System.Data.SqlServerCe

SqlCeConnection

SqlCeCommand

DataSet

DataTable