SqlCeDataAdapter Class

Articolo
01/14/2011

Rappresenta un set di comandi di dati e una connessione a un database utilizzati per riempire l'oggetto DataSet e aggiornare l'origine dati.

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

public sealed class SqlCeDataAdapter : DbDataAdapter, ICloneable

public ref class SqlCeDataAdapter sealed : public DbDataAdapter, ICloneable

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

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.

Gerarchia di ereditarietà

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

Esempio

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();
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeDataAdapter Members
System.Data.SqlServerCe Namespace
SqlCeConnection Class
SqlCeCommand Class
DataSet
DataTable

Condividi tramite