OleDbDataAdapter 類別

定義

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

繼承

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

實作

IDataAdapter IDbDataAdapter ICloneable

範例

以下範例使用 OleDbCommand、 OleDbDataAdapter 和 OleDbConnection，從存取資料來源中選取紀錄，並將選取的列填入 a DataSet 。 填充 DataSet 物隨後會被歸還。 為達成此目的，方法會傳遞一個初始化的 DataSet、一個連接字串，以及一個查詢字串，該查詢字串是 SQL 的 SELECT 語句。

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

備註

它 OleDbDataAdapter 作為連接資料 DataSet 來源的橋樑，用於擷取與儲存資料。 透過 OleDbDataAdapter 將 Fill 資料從資料來源載入 DataSet至 ，並透過將 Update 先前所做的 DataSet 變更傳送回資料來源，來提供此橋接。

當 填 OleDbDataAdapter 入 時 DataSet，若回傳資料尚未存在，則會為回傳資料建立相應的表格和欄位。 然而，除非 MissingSchemaAction 將屬性設為 AddWithKey，否則隱式建立的結構中不會包含主鍵資訊。 你也可以先 OleDbDataAdapter 建立 的結構 DataSet結構，包含主鍵資訊，然後再用 來填充資料 FillSchema。 欲了解更多資訊，請參閱 「將現有約束加入資料集」。

請注意，部分 OLE DB 提供者，包括 MSDataShape 提供者，不會回傳基底表或主鍵資訊。 因此，無法 OleDbDataAdapter 正確設定 PrimaryKey 任何所創造 DataTable的屬性。 在這種情況下，你應該明確指定 . 中資料表 DataSet的主鍵。

同時 OleDbDataAdapter 也包含 SelectCommand、 InsertCommand、 DeleteCommand、 UpdateCommand及 TableMappings 屬性，以便載入與更新資料。

當你建立 的 OleDbDataAdapter實例時，屬性會設定為初始值。 如需這些值的清單，請參閱建構函式 OleDbDataAdapter 。

另請參閱

• DataAdapter 和 DataReader