Класс SqlCeDataAdapter
Представляет набор команд данных и подключения к базе данных, которые используются для заполнения DataSet и обновления источника данных.
Иерархия наследования
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DataAdapter
System.Data.Common.DbDataAdapter
System.Data.SqlServerCe.SqlCeDataAdapter
Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)
Синтаксис
'Декларация
Public NotInheritable Class SqlCeDataAdapter _
Inherits DbDataAdapter _
Implements ICloneable
'Применение
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
Тип SqlCeDataAdapter обеспечивает доступ к следующим элементам.
Конструкторы
| Имя | Описание | |
|---|---|---|
.gif "Открытый метод") |
SqlCeDataAdapter() | Инициализация нового экземпляра класса SqlCeDataAdapter. |
|
SqlCeDataAdapter(SqlCeCommand) | Инициализирует новый экземпляр класса SqlCeDataAdapter объектом SqlCeCommand, указанным в свойстве SelectCommand. |
|
SqlCeDataAdapter(String, SqlCeConnection) | Инициализирует новый экземпляр класса SqlCeDataAdapter на основе значения SelectCommand и объекта SqlCeConnection. |
|
SqlCeDataAdapter(String, String) | Инициализирует новый экземпляр класса SqlCeDataAdapter на основе объекта SelectCommand и строки подключения. |
В начало
Свойства
| Имя | Описание | |
|---|---|---|
.gif "Открытое свойство") |
AcceptChangesDuringFill | (унаследовано из DataAdapter) |
|
AcceptChangesDuringUpdate | (унаследовано из DataAdapter) |
.gif "Защищенное свойство") |
CanRaiseEvents | (унаследовано из Component) |
|
Container | (унаследовано из Component) |
|
ContinueUpdateOnError | (унаследовано из DataAdapter) |
|
DeleteCommand | Возвращает или задает инструкцию SQL для удаления записей из набора данных. |
|
DesignMode | (унаследовано из Component) |
|
Events | (унаследовано из Component) |
|
FillCommandBehavior | (унаследовано из DbDataAdapter) |
|
FillLoadOption | (унаследовано из DataAdapter) |
|
InsertCommand | Возвращает или задает инструкцию SQL, используемую для вставки в источник данных новых записей. |
|
MissingMappingAction | (унаследовано из DataAdapter) |
|
MissingSchemaAction | (унаследовано из DataAdapter) |
|
ReturnProviderSpecificTypes | (унаследовано из DataAdapter) |
|
SelectCommand | Возвращает или задает инструкцию SQL, используемую для выборки записей в источнике данных. |
|
Site | (унаследовано из Component) |
|
TableMappings | (унаследовано из DataAdapter) |
|
UpdateBatchSize | (унаследовано из DbDataAdapter) |
|
UpdateCommand | Возвращает или задает инструкцию SQL, используемую для обновления записей в источнике данных. |
В начало
Методы
.gif "Защищенный метод")
В начало
События
| Имя | Описание | |
|---|---|---|
.gif "Открытое событие") |
Disposed | (унаследовано из Component) |
|
FillError | (унаследовано из DataAdapter) |
|
RowUpdated | Возникает при вызове метода Update, когда выполняется команда обновления для источника данных. Производится попытка обновления, а затем вызывается это событие. |
|
RowUpdating | Возникает при вызове метода Update перед выполнением команды обновления в источнике данных. Производится попытка обновления, а затем вызывается это событие. |
В начало
Явные реализации интерфейса
| Имя | Описание | |
|---|---|---|
.gif "Явная реализация интерфейса") .gif "Закрытый метод") |
ICloneable.Clone | Описание этого элемента см. в разделе ICloneable.Clone(). |
.gif "Закрытое свойство") |
IDbDataAdapter.DeleteCommand | (унаследовано из DbDataAdapter) |
|
IDbDataAdapter.InsertCommand | (унаследовано из DbDataAdapter) |
|
IDbDataAdapter.SelectCommand | (унаследовано из DbDataAdapter) |
|
IDataAdapter.TableMappings | (унаследовано из DataAdapter) |
|
IDbDataAdapter.UpdateCommand | (унаследовано из DbDataAdapter) |
В начало
Замечания
Адаптер обработки данных SqlCeDataAdapter обеспечивает связь между набором данных DataSet и источником данных. Он производит выборку и сохранение данных в источнике данных. Объект SqlCeDataAdapter загружает данные из источника данных в DataSet методом Fill, а также отправляет данные из DataSet обратно в источник данных методом Update.
При заполнении объекта SqlCeDataAdapter в DataSet для возвращенных данных создается необходимое число таблиц и столбцов, если эти объекты еще не созданы. Но если свойство MissingSchemaAction отлично от AddWithKey, то сведения о первичном ключе не будут включены в неявно созданную схему. Объект SqlCeDataAdapter может также создать схему DataSet, включая сведения о первичном ключе, а затем заполнить ее данными методом FillSchema.
Объект SqlCeDataAdapter имеет свойства SelectCommand, InsertCommand, DeleteCommand, UpdateCommand и TableMappings, позволяющие упростить загрузку и обновление данных.
При создании экземпляра SqlCeDataAdapter свойствам присваиваются их начальные значения. Список этих значений см. в конструкторе 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) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.