IDbDataAdapter Rozhraní
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje sadu vlastností souvisejících s příkazy, které se používají k vyplnění DataSet a aktualizaci zdroje dat a je implementována zprostředkovateli dat .NET, kteří přistupují k relačním databázím.
public interface class IDbDataAdapter : System::Data::IDataAdapter
public interface IDbDataAdapter : System.Data.IDataAdapter
type IDbDataAdapter = interface
interface IDataAdapter
Public Interface IDbDataAdapter
Implements IDataAdapter
- Odvozené
- Implementuje
Příklady
Následující příklad používá k výběru záznamů ze zdroje dat odvozené třídy SqlCommand, SqlDataAdapter a SqlConnection. Vyplněný DataSet se pak vrátí. Za tímto účelem se metodě předá inicializovaný DataSetřetězec , připojovací řetězec a řetězec dotazu, který je příkazem 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
Poznámky
Rozhraní IDbDataAdapter dědí z IDataAdapter rozhraní a umožňuje objektu vytvořit objekt DataAdapter navržený pro použití s relační databází. Rozhraní IDbDataAdapter a volitelně i třída DbDataAdapternástrojů , umožňují dědící třídě implementovat třídu DataAdapter, která představuje most mezi zdrojem dat a DataSet. Další informace o třídách DataAdapter najdete v tématu Naplnění datové sady z objektu DataAdapter. Další informace o implementaci zprostředkovatelů dat rozhraní .NET Framework najdete v tématu Implementace zprostředkovatele dat rozhraní .NET Framework.
Aplikace nevytvoří instanci IDbDataAdapter rozhraní přímo, ale vytvoří instanci třídy, která dědí IDbDataAdapter a DbDataAdapter.
Třídy, které dědí IDbDataAdapter , musí implementovat zděděné členy a obvykle definovat další členy pro přidání funkcí specifických pro zprostředkovatele. Například IDbDataAdapter rozhraní definuje SelectCommand vlastnost a DbDataAdapter rozhraní definuje metodu Fill , která přebírá DataTable jako parametr . Třída zase OleDbDataAdapter dědí SelectCommand vlastnost a metodu Fill a také definuje dvě další přetížení Fill metody, která přebírá objekt ADO Recordset jako parametr.
Poznámky pro implementátory
Chcete-li zvýšit konzistenci mezi zprostředkovateli dat rozhraní .NET Framework, pojmenujte dědící třídu ve formátu Prv
DataAdapter, kde Prv
je jednotná předpona přidělená všem třídám v určitém oboru názvů zprostředkovatele dat rozhraní .NET Framework. Je například Sql
předponou SqlDataAdapter třídy v System.Data.SqlClient
oboru názvů.
Při dědění z IDbDataAdapter rozhraní byste měli implementovat následující konstruktory:
Položka | Popis |
---|---|
PrvDataAdapter() | Inicializuje novou instanci PrvDataAdapter třídy. |
PrvDataAdapter(PrvCommand selectCommand) | Inicializuje novou instanci PrvDataAdapter třídy pomocí zadaného příkazu SQL SELECT. |
PrvDataAdapter(string selectCommandText, string selectConnectionString) | Inicializuje novou instanci PrvDataAdapter třídy pomocí příkazu SQL SELECT a připojovacího řetězce. |
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) | Inicializuje novou instanci PrvDataAdapter třídy pomocí příkazu SQL SELECT a PrvConnection objektu. |
Vlastnosti
DeleteCommand |
Získá nebo nastaví příkaz SQL pro odstranění záznamů z datové sady. |
InsertCommand |
Získá nebo nastaví příkaz SQL sloužící k vložení nových záznamů do zdroje dat. |
MissingMappingAction |
Určuje nebo určuje, zda se mají nemapované zdrojové tabulky nebo sloupce předávat se svými názvy zdrojů, aby bylo možné je filtrovat nebo vyvolat chybu. (Zděděno od IDataAdapter) |
MissingSchemaAction |
Označuje nebo určuje, jestli se chybějící zdrojové tabulky, sloupce a jejich relace přidají do schématu datové sady, ignorují nebo způsobí vyvolání chyby. (Zděděno od IDataAdapter) |
SelectCommand |
Získá nebo nastaví příkaz SQL použitý k výběru záznamů ve zdroji dat. |
TableMappings |
Získá kolekci, která označuje, jak je zdrojová tabulka mapována na tabulku datové sady. (Zděděno od IDataAdapter) |
UpdateCommand |
Získá nebo nastaví příkaz SQL sloužící k aktualizaci záznamů ve zdroji dat. |
Metody
Fill(DataSet) |
Přidá nebo aktualizuje řádky v objektu DataSet tak, aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvu, a vytvoří pojmenovanou DataTable "Tabulku". (Zděděno od IDataAdapter) |
FillSchema(DataSet, SchemaType) |
Přidá pojmenovanou DataTable "Tabulku" k zadanému DataSet a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaného SchemaType. (Zděděno od IDataAdapter) |
GetFillParameters() |
Získá parametry nastavené uživatelem při spuštění příkazu SQL SELECT. (Zděděno od IDataAdapter) |
Update(DataSet) |
Volá příslušné příkazy INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v zadaném DataSet z pojmenovaného DataTable "Table". (Zděděno od IDataAdapter) |
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro