IDbDataAdapter 介面

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

代表一組與命令相關的屬性，這些屬性是用來填入 DataSet 並更新資料來源，並且由存取關聯式資料庫的 .NET 資料提供者所實作。

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

衍生

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

實作

IDataAdapter

範例

下列範例會使用 衍生類別 、 SqlCommandSqlDataAdapter 和 SqlConnection，從數據源中選取記錄。 然後會傳回填滿 DataSet 的 。 為了達成此目的，方法會傳遞初始化 DataSet的 、連接字串，以及 Transact-SQL SELECT 語句的查詢字串。

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

備註

介面 IDbDataAdapter 繼承自 IDataAdapter 介面，並允許 物件建立DataAdapter，其設計目的是要與關係資料庫搭配使用。 介面 IDbDataAdapter 和 公用程式類別 DbDataAdapter選擇性地允許繼承類別實作DataAdapter類別，這代表數據源與 DataSet之間的網橋。 如需 DataAdapter 類別的詳細資訊，請參閱 從 DataAdapter 填入 DataSet。 如需實作 .NET Framework 數據提供者的詳細資訊，請參閱 實作 .NET Framework 數據提供者。

應用程式不會直接建立 介面的 IDbDataAdapter 實例，而是建立繼承 IDbDataAdapter 和 DbDataAdapter的類別實例。

繼承 IDbDataAdapter 的類別必須實作繼承的成員，而且通常會定義其他成員來新增提供者特定的功能。 例如， IDbDataAdapter 介面會 SelectCommand 定義 屬性，而 DbDataAdapter 介面會 Fill 定義採用 DataTable 做為參數的方法。 接著，類別 OleDbDataAdapter 會 SelectCommand 繼承 屬性和 Fill 方法，並定義方法的 Fill 兩個額外多載，該方法會採用 ADO Recordset 物件做為參數。

給實施者的注意事項

若要提升 .NET Framework 數據提供者之間的一致性，請將繼承類別命名為 DataAdapter 格式 Prv ，其中 Prv 是指定給特定 .NET Framework 數據提供者命名空間中所有類別的統一前置詞。 例如， Sql 是命名空間中 類別的SqlDataAdapterSystem.Data.SqlClient前置詞。

當您繼承自 介面時 IDbDataAdapter ，應該實作下列建構函式：

項目	描述
PrvDataAdapter ()	初始化 PrvDataAdapter 類別的新實例。
PrvDataAdapter (PrvCommand selectCommand)	使用指定的 SQL SELECT 語句，初始化 PrvDataAdapter 類別的新實例。
PrvDataAdapter (字串 selectCommandText， string selectConnectionString)	使用 SQL SELECT 語句和連接字串，初始化 PrvDataAdapter 類別的新實例。
PrvDataAdapter (字串 selectCommandText， PrvConnection selectConnection)	使用 SQL SELECT 語句和 PrvConnection 物件，初始化 PrvDataAdapter 類別的新實例。

屬性

DeleteCommand	取得或設定 SQL 陳述式從資料集刪除資料錄。
InsertCommand	取得或設定用來將新的資料錄插入至資料來源的 SQL 陳述式。
MissingMappingAction	指示或指定未對應的來源資料表或資料行是否為了篩選或引發錯誤，而使用它們的來源名稱傳遞。 (繼承來源 IDataAdapter)
MissingSchemaAction	指示或指定遺漏的來源資料表、資料行和關聯性 (Relationship) 是否加入至資料集結構描述 (Schema)、已忽略，或造成要引發的錯誤。 (繼承來源 IDataAdapter)
SelectCommand	取得或設定用來在資料來源中選取資料錄的 SQL 陳述式。
TableMappings	取得集合，指出源數據表如何對應至數據集數據表。 (繼承來源 IDataAdapter)
UpdateCommand	取得或設定用來在資料來源中更新資料錄的 SQL 陳述式。

方法

Fill(DataSet)	使用 DataSet 名稱，加入或更新 DataSet 中的資料列，以符合那些在資料來源中的資料列，並建立命名為 "Table" 的 DataTable。 (繼承來源 IDataAdapter)
FillSchema(DataSet, SchemaType)	將名稱為 "Table" 的 DataTable 加入至指定的 DataSet，並根據指定的 SchemaType，設定結構描述以符合資料來源中的資料表。 (繼承來源 IDataAdapter)
GetFillParameters()	取得在執行 SQL SELECT 陳述式時由使用者設定的參數。 (繼承來源 IDataAdapter)
Update(DataSet)	從命名為 "Table" 之 DataSet 的指定 DataTable 中，為每個插入、更新或刪除的資料列呼叫對應的 INSERT、UPDATE 或 DELETE 陳述式。 (繼承來源 IDataAdapter)