SqlCeDataAdapter Class

Статья
01/14/2011

Представляет набор команд данных и соединение с базой данных, которые используются для заполнения DataSet и обновления источника данных.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в system.data.sqlserverce.dll)

Синтаксис

'Декларация
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

Замечания

Адаптер обработки данных SqlCeDataAdapter обеспечивает связь между набором данных DataSet и источником данных. Он производит выборку и сохранение данных в источнике данных. Объект SqlCeDataAdapter загружает данные из источника данных в DataSet методом Fill, а также отправляет данные из DataSet обратно в источник данных методом Update.

При заполнении объекта SqlCeDataAdapter в DataSet для возвращенных данных создается необходимое число таблиц и столбцов, если эти объекты еще не созданы. Но если свойство MissingSchemaAction отлично от AddWithKey, то сведения о первичном ключе не будут включены в неявно созданную схему. Объект SqlCeDataAdapter может также создать схему DataSet, включая сведения о первичном ключе, а затем заполнить ее данными методом FillSchema.

Объект SqlCeDataAdapter имеет свойства SelectCommand, InsertCommand, DeleteCommand, UpdateCommand и TableMappings, позволяющие упростить загрузку и обновление данных.

При создании экземпляра SqlCeDataAdapter свойствам присваиваются их начальные значения. Список этих значений см. в конструкторе SqlCeDataAdapter.

Иерархия наследования

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

Пример

В следующем примере объекты SqlCeCommand, SqlCeDataAdapter и SqlCeConnection используются для выборки записей из источника данных и заполнения DataSet выбранными строками. Затем производится возврат заполненного набора данных DataSet. Для выполнения этой задачи методу передаются инициализированный объект DataSet, строка соединения и строка запроса, представляющая собой 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();
}

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

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
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

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

Поделиться через