IDbDataAdapter Interfész

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

IDbDataAdapter.cs

A DataSet kitöltéséhez és az adatforrás frissítéséhez használt, a relációs adatbázisokhoz hozzáférő .NET adatszolgáltatók által implementált parancsokkal kapcsolatos tulajdonságok halmazát jelöli.

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

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Származtatott

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Megvalósítás

IDataAdapter

Példák

Az alábbi példa a származtatott osztályokat SqlCommandSqlDataAdapterSqlConnectionés az adatforrásból származó rekordok kiválasztását használja. Ezután visszaadja a kitöltött elemet DataSet . Ennek elvégzéséhez a metódus egy inicializált DataSet, egy kapcsolati karakterlánc és egy Transact-SQL SELECT utasítást tartalmazó lekérdezési sztringet ad át.

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

Megjegyzések

Az IDbDataAdapter interfész öröklődik az IDataAdapter interfésztől, és lehetővé teszi, hogy egy objektum relációs adatbázishoz tervezett DataAdaptert hozzon létre. Az IDbDataAdapter interfész és opcionálisan a segédprogramosztály lehetővé teszi, DbDataAdapterhogy egy öröklő osztály implementáljon egy DataAdapter-osztályt, amely egy adatforrás és egy DataSet. A DataAdapter-osztályokról további információt a DataAdapter-ből származó adathalmaz feltöltése című témakörben talál. A .NET-keretrendszer adatszolgáltatóinak implementálásával kapcsolatos további információkért lásd: A .NET-keretrendszer Data Provider.

Az alkalmazás nem hozza létre közvetlenül a IDbDataAdapter felület egy példányát, hanem létrehoz egy példányt egy osztályból, amely örökli IDbDataAdapter és DbDataAdapter.

Az öröklő IDbDataAdapter osztályoknak implementálniuk kell az örökölt tagokat, és általában további tagokat kell meghatározniuk a szolgáltatóspecifikus funkciók hozzáadásához. Az interfész például IDbDataAdapter meghatározza a SelectCommand tulajdonságot, az DbDataAdapter interfész pedig egy Fill paramétert használó DataTable metódust határoz meg. Az osztály viszont OleDbDataAdapter örökli a SelectCommand tulajdonságot és a Fill metódust, valamint meghatározza a Fill metódus két további túlterhelését is, amelyek paraméterként egy ADO Recordset objektumot vesznek fel.

Megjegyzések az implementálókhoz

A .NET keretrendszer adatszolgáltatói közötti konzisztencia előmozdításához nevezze el az öröklő osztályt Prv DataAdapter formában, ahol a Prv egy adott .NET keretrendszer adatszolgáltatójának névterében található összes osztály egységes előtagja. Például Sql az osztály előtagja SqlDataAdapter a System.Data.SqlClient névtérben.

Ha a IDbDataAdapter felületről örököl, a következő konstruktorokat kell implementálnia:

Cikk	Leírás
PrvDataAdapter()	Inicializálja a PrvDataAdapter osztály új példányát.
PrvDataAdapter(PrvCommand selectCommand)	Inicializálja a PrvDataAdapter osztály új példányát a megadott SQL SELECT utasítással.
PrvDataAdapter(sztring selectCommandText, sztring selectConnectionString)	Inicializálja a PrvDataAdapter osztály új példányát egy SQL SELECT utasítással és egy kapcsolati karakterlánc.
PrvDataAdapter(sztring selectCommandText, PrvConnection selectConnection)	Inicializálja a PrvDataAdapter osztály új példányát egy SQL SELECT utasítással és egy PrvConnection-objektummal.

Tulajdonságok

Name	Description
DeleteCommand	Lekéri vagy beállít egy SQL-utasítást a rekordok adatkészletből való törléséhez.
InsertCommand	Lekéri vagy beállít egy SQL-utasítást, amellyel új rekordokat szúrhat be az adatforrásba.
MissingMappingAction	Azt jelzi vagy adja meg, hogy a rendszer a nem megfeleltetett forrástáblákat vagy oszlopokat a forrásnevekkel együtt adja-e át a szűréshez vagy hibakereséshez. (Öröklődés forrása IDataAdapter)
MissingSchemaAction	Azt jelzi vagy határozza meg, hogy a hiányzó forrástáblák, oszlopok és kapcsolataik hozzáadódnak-e az adathalmaz sémához, figyelmen kívül hagyják-e őket, vagy hibát okoznak-e. (Öröklődés forrása IDataAdapter)
SelectCommand	Lekéri vagy beállítja az adatforrás rekordjainak kiválasztására szolgáló SQL-utasítást.
TableMappings	Lekéri azt a gyűjteményt, amely azt jelzi, hogy egy forrástábla hogyan van leképezve egy adathalmaztáblára. (Öröklődés forrása IDataAdapter)
UpdateCommand	Lekéri vagy beállítja az adatforrás rekordjainak frissítéséhez használt SQL-utasítást.

Metódusok

Name	Description
Fill(DataSet)	Sorokat ad hozzá vagy frissít az DataSet adatforrásban lévőkkel a DataSet név alapján, és létrehoz egy DataTable "Table" nevű nevet. (Öröklődés forrása IDataAdapter)
FillSchema(DataSet, SchemaType)	Hozzáad egy DataTable "Table" nevű táblát a megadotthoz DataSet , és úgy konfigurálja a sémát, hogy az megfeleljen az adatforrásnak a megadott SchemaTypealapján. (Öröklődés forrása IDataAdapter)
GetFillParameters()	Lekéri a felhasználó által az SQL SELECT utasítás végrehajtásakor beállított paramétereket. (Öröklődés forrása IDataAdapter)
Update(DataSet)	Meghívja a megfelelő INSERT, UPDATE vagy DELETE utasítást az egyes beszúrt, frissített vagy törölt sorokhoz a megadott DataSet "Table" nevű táblából DataTable . (Öröklődés forrása IDataAdapter)