IDataAdapter 介面

  • 參考

定義

命名空間:
System.Data
組件:
System.Data.Common.dll
組件:
System.Data.dll
組件:
netstandard.dll

允許物件實作 DataAdapter，並表示用來填滿和更新 DataSet 並更新資料來源的方法集和對應動作相關屬性集。

IDbDataAdapter 執行個體適用於本身為 (或類似於) 採用文字命令 (例如 Transact-SQL) 之關聯式資料庫的資料來源，而 IDataAdapter 執行個體則可以使用任何類型的資料來源。

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface 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

備註

IDataAdapter介面可讓繼承類別實作DataAdapter類別，代表數據源與DataSet之間的網橋。 如需 DataAdapter 類別的詳細資訊，請參閱 從 DataAdapter 填入 DataSet。

應用程式不會直接建立介面的 IDataAdapter 實例，而是實作繼承 IDataAdapter之類別的實例。

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

給實施者的注意事項

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

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

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

屬性

MissingMappingAction

指示或指定未對應的來源資料表或資料行是否為了篩選或引發錯誤，而使用它們的來源名稱傳遞。
MissingSchemaAction

指示或指定遺漏的來源資料表、資料行和關聯性 (Relationship) 是否加入至資料集結構描述 (Schema)、已忽略，或造成要引發的錯誤。
TableMappings

取得集合，指出源數據表如何對應至數據集數據表。

方法

Fill(DataSet)

使用 DataSet 名稱，加入或更新 DataSet 中的資料列，以符合那些在資料來源中的資料列，並建立命名為 "Table" 的 DataTable。
FillSchema(DataSet, SchemaType)

將名稱為 "Table" 的 DataTable 加入至指定的 DataSet，並根據指定的 SchemaType，設定結構描述以符合資料來源中的資料表。
GetFillParameters()

取得在執行 SQL SELECT 陳述式時由使用者設定的參數。
Update(DataSet)

從命名為 "Table" 之 DataSet 的指定 DataTable 中，為每個插入、更新或刪除的資料列呼叫對應的 INSERT、UPDATE 或 DELETE 陳述式。

適用於