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 | |
|---|---|---|
.gif "Método público") |
SqlCeDataAdapter() | Inicializa una nueva instancia de la clase SqlCeDataAdapter. |
|
SqlCeDataAdapter(SqlCeCommand) | Inicializa una nueva instancia de la clase SqlCeDataAdapter con el objeto SqlCeCommand especificado como propiedad SelectCommand. |
|
SqlCeDataAdapter(String, SqlCeConnection) | Inicializa una nueva instancia de la clase SqlCeDataAdapter con SelectCommand y un objeto SqlCeConnection. |
|
SqlCeDataAdapter(String, String) | Inicializa una nueva instancia de la clase SqlCeDataAdapter con SelectCommand y una cadena de conexión. |
Arriba
Propiedades
| Nombre | Descripción | |
|---|---|---|
.gif "Propiedad pública") |
AcceptChangesDuringFill | (se hereda de DataAdapter) |
|
AcceptChangesDuringUpdate | (se hereda de DataAdapter) |
.gif "Propiedad protegida") |
CanRaiseEvents | (se hereda de Component) |
|
Container | (se hereda de Component) |
|
ContinueUpdateOnError | (se hereda de DataAdapter) |
|
DeleteCommand | Obtiene o establece una instrucción SQL para eliminar registros del conjunto de datos. |
|
DesignMode | (se hereda de Component) |
|
Events | (se hereda de Component) |
|
FillCommandBehavior | (se hereda de DbDataAdapter) |
|
FillLoadOption | (se hereda de DataAdapter) |
|
InsertCommand | Obtiene o establece una instrucción SQL utilizada para insertar nuevos registros en el origen de datos. |
|
MissingMappingAction | (se hereda de DataAdapter) |
|
MissingSchemaAction | (se hereda de DataAdapter) |
|
ReturnProviderSpecificTypes | (se hereda de DataAdapter) |
|
SelectCommand | Obtiene o establece una instrucción SQL utilizada para seleccionar registros en el origen de datos. |
|
Site | (se hereda de Component) |
|
TableMappings | (se hereda de DataAdapter) |
|
UpdateBatchSize | (se hereda de DbDataAdapter) |
|
UpdateCommand | Obtiene o establece una instrucción SQL utilizada para actualizar registros en el origen de datos. |
Arriba
Métodos
.gif "Método protegido")
Arriba
Eventos
| Nombre | Descripción | |
|---|---|---|
.gif "Evento público") |
Disposed | (se hereda de Component) |
|
FillError | (se hereda de DataAdapter) |
|
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. |
|
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 | |
|---|---|---|
.gif "Implementación de interfaces explícitas") .gif "Método privado") |
ICloneable.Clone | Para obtener una descripción de este miembro, vea ICloneable.Clone(). |
.gif "Propiedad privada") |
IDbDataAdapter.DeleteCommand | (se hereda de DbDataAdapter) |
|
IDbDataAdapter.InsertCommand | (se hereda de DbDataAdapter) |
|
IDbDataAdapter.SelectCommand | (se hereda de DbDataAdapter) |
|
IDataAdapter.TableMappings | (se hereda de DataAdapter) |
|
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.