Sdílet prostřednictvím


Rowsets

Platí na:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformový systém (PDW)SQL databáze v Microsoft Fabric

Stáhnout ovladač OLE DB

Řádková sada je sada řádků obsahujících sloupce dat. Řádkové sady jsou centrální objekty, které umožňují všem poskytovatelům dat OLE DB zpřístupnit data výsledkové sady v tabulkové podobě.

Poté, co uživatel vytvoří relaci pomocí metody IDBCreateSession::CreateSession , může uživatel použít buď rozhraní IOpenRowset, nebo IDBCreateCommand na relaci k vytvoření sady řádků. Ovladač OLE DB pro SQL Server podporuje obě tato rozhraní. Obě tyto metody jsou zde popsány.

  • Vytvořte sadu řádků voláním metody IOpenRowset::OpenRowset .

    To je ekvivalentní vytvoření řádkové sady nad jedinou tabulkou. Tato metoda otevírá a vrací sadu řádků, která obsahuje všechny řádky z jedné základní tabulky. Jedním z argumentů OpenRowset je ID tabulky, která identifikuje tabulku, ze které se má řádková sada vytvořit.

  • Vytvořte příkazový objekt voláním metody IDBCreateCommand::CreateCommand .

    Objekt příkazů vykonává příkazy, které poskytovatel podporuje. S ovladačem OLE DB pro SQL Server může uživatel specifikovat jakýkoli Transact-SQL příkaz, například příkaz SELECT nebo volání uložené procedury. Kroky pro vytvoření řádkové sady pomocí příkazového objektu jsou:

    1. Spotřebitel volá metodu IDBCreateCommand::CreateCommand v relaci, aby získal příkazový objekt požadující rozhraní ICommandText na příkazovém objektu. Toto rozhraní ICommandText nastavuje a načítá skutečný text příkazu. Uživatel vyplní textový příkaz voláním metody ICommandText::SetCommandText .

    2. Uživatel volá metodu ICommand::Execute na příkaz. Objekt řádkové sady vytvořený při spuštění příkazu obsahuje výslednou sadu z příkazu.

Uživatel může použít rozhraní ICommandProperties k získání nebo nastavení vlastností řádkové sady vrácené příkazem vykonaným rozhraním ICommand::Execut . Nejčastěji žádanými vlastnostmi jsou rozhraní, která musí řádková sada podporovat. Kromě rozhraní může uživatel požadovat vlastnosti, které mění chování sady řádků nebo rozhraní.

Spotřebitelé uvolňují řádky metodou IRowset::Release . Uvolnění sady řádků uvolní všechny rukojeti řádků, které uživatel na této sadě drží. Uvolnění sady řádků neuvolní příslušenství. Pokud máte rozhraní IAccessor , stále musí být uvolněno.

V této sekci

Viz také

ovladač OLE DB pro programování SQL Serveru