Classe SqlCeDataAdapter
Representa um conjunto de comandos de dados e uma conexão de banco de dados que são usados para preencher o DataSet e atualizar a fonte de dados.
Hierarquia de herança
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DataAdapter
System.Data.Common.DbDataAdapter
System.Data.SqlServerCe.SqlCeDataAdapter
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)
Sintaxe
'Declaração
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
O tipo SqlCeDataAdapter expõe os membros a seguir.
Construtores
| Nome | Descrição | |
|---|---|---|
.gif "Método público") |
SqlCeDataAdapter() | Inicializa uma nova instância da classe SqlCeDataAdapter. |
|
SqlCeDataAdapter(SqlCeCommand) | Inicializa uma nova instância da classe SqlCeDataAdapter com o SqlCeCommand especificado como a propriedade SelectCommand. |
|
SqlCeDataAdapter(String, SqlCeConnection) | Inicializa uma nova instância da classe SqlCeDataAdapter com um SelectCommand e um objeto SqlCeConnection. |
|
SqlCeDataAdapter(String, String) | Inicializa uma nova instância da classe SqlCeDataAdapter com um SelectCommand e uma cadeia de caracteres e conexão. |
Início
Propriedades
| Nome | Descrição | |
|---|---|---|
.gif "Propriedade pública") |
AcceptChangesDuringFill | (herança de DataAdapter) |
|
AcceptChangesDuringUpdate | (herança de DataAdapter) |
.gif "Propriedade protegida") |
CanRaiseEvents | (herança de Component) |
|
Container | (herança de Component) |
|
ContinueUpdateOnError | (herança de DataAdapter) |
|
DeleteCommand | Obtém ou define uma instrução SQL para excluir registros do conjunto de dados. |
|
DesignMode | (herança de Component) |
|
Events | (herança de Component) |
|
FillCommandBehavior | (herança de DbDataAdapter) |
|
FillLoadOption | (herança de DataAdapter) |
|
InsertCommand | Obtém ou define uma instrução SQL usada para inserir novos registros na fonte de dados. |
|
MissingMappingAction | (herança de DataAdapter) |
|
MissingSchemaAction | (herança de DataAdapter) |
|
ReturnProviderSpecificTypes | (herança de DataAdapter) |
|
SelectCommand | Obtém ou define uma instrução SQL usada para selecionar registros na fonte de dados. |
|
Site | (herança de Component) |
|
TableMappings | (herança de DataAdapter) |
|
UpdateBatchSize | (herança de DbDataAdapter) |
|
UpdateCommand | Obtém ou define uma instrução SQL usada para atualizar registros na fonte de dados. |
Início
Métodos
.gif "Método protegido")
Início
Eventos
| Nome | Descrição | |
|---|---|---|
.gif "Evento público") |
Disposed | (herança de Component) |
|
FillError | (herança de DataAdapter) |
|
RowUpdated | Ocorre durante uma chamada para a Update após a execução de um comando de atualização com relação à fonte de dados. A tentativa de atualização é executada e, em seguida, esse evento é acionado. |
|
RowUpdating | Ocorre durante uma chamada para a Update antes da execução de um comando de atualização com relação à fonte de dados. A tentativa de atualização é executada e, em seguida, esse evento é acionado. |
Início
Implementações de interfaces explícitas
| Nome | Descrição | |
|---|---|---|
.gif "Implementações de interfaces explícitas") .gif "Método privado") |
ICloneable.Clone | Para obter uma descrição deste membro, consulte ICloneable.Clone(). |
.gif "Propriedade privada") |
IDbDataAdapter.DeleteCommand | (herança de DbDataAdapter) |
|
IDbDataAdapter.InsertCommand | (herança de DbDataAdapter) |
|
IDbDataAdapter.SelectCommand | (herança de DbDataAdapter) |
|
IDataAdapter.TableMappings | (herança de DataAdapter) |
|
IDbDataAdapter.UpdateCommand | (herança de DbDataAdapter) |
Início
Comentários
O SqlCeDataAdapter atua como uma ponte entre um DataSet e a fonte de dados. Ele é usado para recuperar e salvar dados na fonte de dados. O SqlCeDataAdapter fornece essa ponte usando Fill para carregar dados da fonte de dados no DataSet e usando a Update para enviar as alterações feitas no DataSet de volta à fonte de dados.
Quando o SqlCeDataAdapter preenche um DataSet, as tabelas e colunas necessárias são criadas com os dados retornados, se ainda não existirem. Contudo, as informações da chave primária não serão incluídas no esquema criado implicitamente, a menos que a propriedade MissingSchemaAction seja definida como AddWithKey. Também é possível fazer o SqlCeDataAdapter criar o esquema do DataSet, incluindo informações da chave primária, antes de preenchê-la com dados usando o FillSchema.
O SqlCeDataAdapter inclui as propriedades SelectCommand, InsertCommand, DeleteCommand, UpdateCommand e TableMappings para facilitar o carregamento e a atualização de dados.
Quando você cria uma instância do SqlCeDataAdapter, as propriedades de leitura/gravação a seguir são definidas com os valores iniciais a seguir. Para obter uma lista desses valores, consulte o construtor do SqlCeDataAdapter.
Exemplos
O exemplo a seguir usa o SqlCeCommand, o SqlCeDataAdapter e a SqlCeConnection para selecionar registro de uma fonte de dados e preencher um DataSet com as linhas selecionadas. Então, o DataSet preenchido é retornado. Para tanto, um DataSet, uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SQL SELECT são passados para o método.
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();
}
Segurança de thread
Qualquer membro estático público (Shared no Microsoft Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.