Classe SqlCeDataAdapter
Rappresenta un set di comandi di dati e una connessione a un database utilizzati per riempire l'oggetto DataSet e aggiornare l'origine dati.
Gerarchia di ereditarietà
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DataAdapter
System.Data.Common.DbDataAdapter
System.Data.SqlServerCe.SqlCeDataAdapter
Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Sintassi
'Dichiarazione
Public NotInheritable Class SqlCeDataAdapter _
Inherits DbDataAdapter _
Implements ICloneable
'Utilizzo
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
Nel tipo SqlCeDataAdapter sono esposti i membri seguenti.
Costruttori
| Nome | Descrizione | |
|---|---|---|
.gif "Metodo pubblico") |
SqlCeDataAdapter() | Inizializza una nuova istanza della classe SqlCeDataAdapter. |
|
SqlCeDataAdapter(SqlCeCommand) | Inizializza una nuova istanza della classe SqlCeDataAdapter con l'oggetto SqlCeCommand specificato come la proprietà SelectCommand. |
|
SqlCeDataAdapter(String, SqlCeConnection) | Inizializza una nuova istanza della classe SqlCeDataAdapter con una proprietà SelectCommand e un oggetto SqlCeConnection. |
|
SqlCeDataAdapter(String, String) | Inizializza una nuova istanza della classe SqlCeDataAdapter con una proprietà SelectCommand e una stringa di connessione. |
In alto
Proprietà
| Nome | Descrizione | |
|---|---|---|
.gif "Proprietà pubblica") |
AcceptChangesDuringFill | (ereditato da DataAdapter) |
|
AcceptChangesDuringUpdate | (ereditato da DataAdapter) |
.gif "Proprietà protetta") |
CanRaiseEvents | (ereditato da Component) |
|
Container | (ereditato da Component) |
|
ContinueUpdateOnError | (ereditato da DataAdapter) |
|
DeleteCommand | Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati. |
|
DesignMode | (ereditato da Component) |
|
Events | (ereditato da Component) |
|
FillCommandBehavior | (ereditato da DbDataAdapter) |
|
FillLoadOption | (ereditato da DataAdapter) |
|
InsertCommand | Ottiene o imposta un'istruzione SQL utilizzata per inserire nuovi record nell'origine dati. |
|
MissingMappingAction | (ereditato da DataAdapter) |
|
MissingSchemaAction | (ereditato da DataAdapter) |
|
ReturnProviderSpecificTypes | (ereditato da DataAdapter) |
|
SelectCommand | Ottiene o imposta un'istruzione SQL utilizzata per selezionare i record nell'origine dati. |
|
Site | (ereditato da Component) |
|
TableMappings | (ereditato da DataAdapter) |
|
UpdateBatchSize | (ereditato da DbDataAdapter) |
|
UpdateCommand | Ottiene o imposta un'istruzione SQL utilizzata per aggiornare i record nell'origine dati. |
In alto
Metodi
.gif "Metodo protetto")
In alto
Eventi
| Nome | Descrizione | |
|---|---|---|
.gif "Evento pubblico") |
Disposed | (ereditato da Component) |
|
FillError | (ereditato da DataAdapter) |
|
RowUpdated | Si verifica durante una chiamata al metodo Update in seguito all'esecuzione di un comando di aggiornamento nell'origine dati. L'evento viene generato al tentativo di eseguire l'aggiornamento. |
|
RowUpdating | Si verifica durante una chiamata al metodo Update prima dell'esecuzione di un comando di aggiornamento nell'origine dati. L'evento viene generato al tentativo di eseguire l'aggiornamento. |
In alto
Implementazioni esplicite dell'interfaccia
| Nome | Descrizione | |
|---|---|---|
.gif "Implementazione esplicita dell'interfaccia") .gif "Metodo privato") |
ICloneable.Clone | Per una descrizione di questo membro, vedere ICloneable.Clone(). |
.gif "Proprietà privata") |
IDbDataAdapter.DeleteCommand | (ereditato da DbDataAdapter) |
|
IDbDataAdapter.InsertCommand | (ereditato da DbDataAdapter) |
|
IDbDataAdapter.SelectCommand | (ereditato da DbDataAdapter) |
|
IDataAdapter.TableMappings | (ereditato da DataAdapter) |
|
IDbDataAdapter.UpdateCommand | (ereditato da DbDataAdapter) |
In alto
Osservazioni
L'oggetto SqlCeDataAdapter funge da ponte tra un oggetto DataSet e un'origine dati. Viene utilizzato per recuperare dati dall'origine dati e per salvare dati nell'origine dati. La classe SqlCeDataAdapter consente di realizzare tale collegamento tramite il metodo Fill per caricare i dati dall'origine dati nella classe DataSet e tramite il metodo Update per inviare nuovamente all'origine dati le modifiche apportate nella classe DataSet.
Quando vengono inseriti dati in un oggetto DataSet mediante SqlCeDataAdapter, vengono create le tabelle e le colonne necessarie per i dati restituiti, se non già esistenti. Le informazioni sulla chiave primaria non saranno incluse nello schema creato in maniera implicita a meno che la proprietà MissingSchemaAction non sia impostata su AddWithKey. È possibile inoltre fare in modo che lo schema dell'oggetto DataSet venga creato dall'oggetto SqlCeDataAdapter, incluse le informazioni sulla chiave primaria, prima dell'inserimento dei dati mediante il metodo FillSchema.
L'oggetto SqlCeDataAdapter contiene le proprietà SelectCommand, InsertCommand, DeleteCommand, UpdateCommand e TableMappings mediante le quali viene semplificato il caricamento e l'aggiornamento dei dati.
Quando si crea un'istanza della classe SqlCeDataAdapter, le proprietà vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il costruttore della classe SqlCeDataAdapter.
Esempi
Nell'esempio che segue sono utilizzati gli oggetti SqlCeCommand, SqlCeDataAdapter e SqlCeConnection per selezionare record da un'origine dati e compilare un oggetto DataSet con le righe selezionate. Viene quindi restituito l'oggetto DataSet compilato. A tale scopo, al metodo viene passato un oggetto DataSet inizializzato, una stringa di connessione e una stringa di query che rappresenta un'istruzione SQL SELECT.
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();
}
Protezione dei thread
I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.