Condividi tramite


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
Metodo pubblico SqlCeDataAdapter() Inizializza una nuova istanza della classe SqlCeDataAdapter.
Metodo pubblico SqlCeDataAdapter(SqlCeCommand) Inizializza una nuova istanza della classe SqlCeDataAdapter con l'oggetto SqlCeCommand specificato come la proprietà SelectCommand.
Metodo pubblico SqlCeDataAdapter(String, SqlCeConnection) Inizializza una nuova istanza della classe SqlCeDataAdapter con una proprietà SelectCommand e un oggetto SqlCeConnection.
Metodo pubblico SqlCeDataAdapter(String, String) Inizializza una nuova istanza della classe SqlCeDataAdapter con una proprietà SelectCommand e una stringa di connessione.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica AcceptChangesDuringFill (ereditato da DataAdapter)
Proprietà pubblica AcceptChangesDuringUpdate (ereditato da DataAdapter)
Proprietà protetta CanRaiseEvents (ereditato da Component)
Proprietà pubblica Container (ereditato da Component)
Proprietà pubblica ContinueUpdateOnError (ereditato da DataAdapter)
Proprietà pubblica DeleteCommand Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati.
Proprietà protetta DesignMode (ereditato da Component)
Proprietà protetta Events (ereditato da Component)
Proprietà protetta FillCommandBehavior (ereditato da DbDataAdapter)
Proprietà pubblica FillLoadOption (ereditato da DataAdapter)
Proprietà pubblica InsertCommand Ottiene o imposta un'istruzione SQL utilizzata per inserire nuovi record nell'origine dati.
Proprietà pubblica MissingMappingAction (ereditato da DataAdapter)
Proprietà pubblica MissingSchemaAction (ereditato da DataAdapter)
Proprietà pubblica ReturnProviderSpecificTypes (ereditato da DataAdapter)
Proprietà pubblica SelectCommand Ottiene o imposta un'istruzione SQL utilizzata per selezionare i record nell'origine dati.
Proprietà pubblica Site (ereditato da Component)
Proprietà pubblica TableMappings (ereditato da DataAdapter)
Proprietà pubblica UpdateBatchSize (ereditato da DbDataAdapter)
Proprietà pubblica UpdateCommand Ottiene o imposta un'istruzione SQL utilizzata per aggiornare i record nell'origine dati.

In alto

Metodi

  Nome Descrizione
Metodo protetto AddToBatch (ereditato da DbDataAdapter)
Metodo protetto ClearBatch (ereditato da DbDataAdapter)
Metodo protetto CloneInternals Obsoleto. (ereditato da DataAdapter)
Metodo pubblico CreateObjRef (ereditato da MarshalByRefObject)
Metodo protetto CreateRowUpdatedEvent (ereditato da DbDataAdapter)
Metodo protetto CreateRowUpdatingEvent (ereditato da DbDataAdapter)
Metodo protetto CreateTableMappings (ereditato da DataAdapter)
Metodo pubblico Dispose() Elimina l'istanza corrente.
Metodo protetto Dispose(Boolean) (ereditato da DbDataAdapter)
Metodo pubblico Equals (ereditato da Object)
Metodo protetto ExecuteBatch (ereditato da DbDataAdapter)
Metodo pubblico Fill(DataSet) (ereditato da DbDataAdapter)
Metodo pubblico Fill(DataTable) (ereditato da DbDataAdapter)
Metodo pubblico Fill(DataSet, String) (ereditato da DbDataAdapter)
Metodo protetto Fill(DataTable, IDataReader) (ereditato da DataAdapter)
Metodo pubblico Fill(Int32, Int32, array<DataTable[]) (ereditato da DbDataAdapter)
Metodo protetto Fill(DataTable, IDbCommand, CommandBehavior) (ereditato da DbDataAdapter)
Metodo pubblico Fill(DataSet, Int32, Int32, String) (ereditato da DbDataAdapter)
Metodo protetto Fill(array<DataTable[], IDataReader, Int32, Int32) (ereditato da DataAdapter)
Metodo protetto Fill(array<DataTable[], Int32, Int32, IDbCommand, CommandBehavior) (ereditato da DbDataAdapter)
Metodo protetto Fill(DataSet, String, IDataReader, Int32, Int32) (ereditato da DataAdapter)
Metodo protetto Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) (ereditato da DbDataAdapter)
Metodo pubblico FillSchema(DataTable, SchemaType) (ereditato da DbDataAdapter)
Metodo pubblico FillSchema(DataSet, SchemaType) (ereditato da DbDataAdapter)
Metodo pubblico FillSchema(DataSet, SchemaType, String) (ereditato da DbDataAdapter)
Metodo protetto FillSchema(DataTable, SchemaType, IDataReader) (ereditato da DataAdapter)
Metodo protetto FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) (ereditato da DbDataAdapter)
Metodo protetto FillSchema(DataSet, SchemaType, String, IDataReader) (ereditato da DataAdapter)
Metodo protetto FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) (ereditato da DbDataAdapter)
Metodo protetto Finalize (ereditato da Component)
Metodo protetto GetBatchedParameter (ereditato da DbDataAdapter)
Metodo protetto GetBatchedRecordsAffected (ereditato da DbDataAdapter)
Metodo pubblico GetFillParameters (ereditato da DbDataAdapter)
Metodo pubblico GetHashCode (ereditato da Object)
Metodo pubblico GetLifetimeService (ereditato da MarshalByRefObject)
Metodo protetto GetService (ereditato da Component)
Metodo pubblico GetType (ereditato da Object)
Metodo protetto HasTableMappings (ereditato da DataAdapter)
Metodo protetto InitializeBatching (ereditato da DbDataAdapter)
Metodo pubblico InitializeLifetimeService (ereditato da MarshalByRefObject)
Metodo protetto MemberwiseClone() (ereditato da Object)
Metodo protetto MemberwiseClone(Boolean) (ereditato da MarshalByRefObject)
Metodo protetto OnFillError (ereditato da DataAdapter)
Metodo protetto OnRowUpdated (ereditato da DbDataAdapter)
Metodo protetto OnRowUpdating (ereditato da DbDataAdapter)
Metodo pubblico ResetFillLoadOption (ereditato da DataAdapter)
Metodo pubblico ShouldSerializeAcceptChangesDuringFill (ereditato da DataAdapter)
Metodo pubblico ShouldSerializeFillLoadOption (ereditato da DataAdapter)
Metodo protetto ShouldSerializeTableMappings (ereditato da DataAdapter)
Metodo protetto TerminateBatching (ereditato da DbDataAdapter)
Metodo pubblico ToString (ereditato da Component)
Metodo pubblico Update(DataSet) (ereditato da DbDataAdapter)
Metodo pubblico Update(array<DataRow[]) (ereditato da DbDataAdapter)
Metodo pubblico Update(DataTable) (ereditato da DbDataAdapter)
Metodo pubblico Update(DataSet, String) (ereditato da DbDataAdapter)
Metodo protetto Update(array<DataRow[], DataTableMapping) (ereditato da DbDataAdapter)

In alto

Eventi

  Nome Descrizione
Evento pubblico Disposed (ereditato da Component)
Evento pubblico FillError (ereditato da DataAdapter)
Evento pubblico 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.
Evento pubblico 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
Implementazione esplicita dell'interfacciaMetodo privato ICloneable.Clone Per una descrizione di questo membro, vedere ICloneable.Clone().
Implementazione esplicita dell'interfacciaProprietà privata IDbDataAdapter.DeleteCommand (ereditato da DbDataAdapter)
Implementazione esplicita dell'interfacciaProprietà privata IDbDataAdapter.InsertCommand (ereditato da DbDataAdapter)
Implementazione esplicita dell'interfacciaProprietà privata IDbDataAdapter.SelectCommand (ereditato da DbDataAdapter)
Implementazione esplicita dell'interfacciaProprietà privata IDataAdapter.TableMappings (ereditato da DataAdapter)
Implementazione esplicita dell'interfacciaProprietà privata 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.

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe

SqlCeConnection

SqlCeCommand

DataSet

DataTable