IDbDataAdapter 介面

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

組件:

System.Data.dll

組件:

netstandard.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

範例

下列範例會使用 衍生類別 SqlCommand 、 SqlDataAdapter 和 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 Data Provider。

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

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

給實施者的注意事項

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

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

項目	描述
PrvDataAdapter ()	初始化 PrvDataAdapter 類別的新實例。
PrvDataAdapter (PrvCommand selectCommand)	使用指定的 SQL SELECT 語句，初始化 PrvDataAdapter 類別的新實例。
PrvDataAdapter (字串 selectCommandText，字串 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)