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) | 使用指定的 SqlCeCommand 做為 SelectCommand 屬性以初始化 SqlCeDataAdapter 類別的新執行個體。 |
|
SqlCeDataAdapter(String, SqlCeConnection) | 使用 SelectCommand 和 SqlCeConnection 物件初始化 SqlCeDataAdapter 類別的新執行個體。 |
|
SqlCeDataAdapter(String, String) | 使用 SelectCommand 和連接字串以初始化 SqlCeDataAdapter 類別的新執行個體。 |
上層
屬性
| 名稱 | 說明 | |
|---|---|---|
.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 藉由使用 Fill 將資料從資料來源載入到 DataSet，並使用 Update 將在 DataSet 中所做的變更傳回到資料來源，來提供這座橋樑。
當 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();
}
執行緒安全性
這個類型的任何公用靜態 (在 Microsoft Visual Basic 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。