Share via


Rijenset

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

OLE DB-stuurprogramma downloaden

Een rijset is een verzameling rijen die kolommen met gegevens bevatten. Rijsets zijn centrale objecten die alle OLE DB-gegevensproviders in staat stellen resultaatgegevens in tabelvorm te presenteren.

Nadat een consument een sessie heeft aangemaakt met de IDBCreateSession::CreateSession-methode , kan de consument de IOpenRowset- of IDBCreateCommand-interface op de sessie gebruiken om een rowset te maken. De OLE DB Driver voor SQL Server ondersteunt beide interfaces. Beide methoden worden hier beschreven.

  • Maak een rowset aan door de IOpenRowset::OpenRowset-methode aan te roepen.

    Dit is gelijk aan het maken van een rijset over één enkele tabel. Deze methode opent en geeft een rijenset terug die alle rijen uit één basistabel bevat. Een van de argumenten voor OpenRowset is een tabel-ID die de tabel identificeert waaruit de rowset moet worden gemaakt.

  • Maak een commandoobject aan door de IDBCreateCommand::CreateCommand-methode aan te roepen.

    Het commando-object voert commando's uit die de provider ondersteunt. Met de OLE DB Driver voor SQL Server kan de consument elk Transact-SQL-statement specificeren, zoals een SELECT-instructie of een aanroep naar een opgeslagen procedure. De stappen voor het aanmaken van een rijset met behulp van een commando-object zijn:

    1. De consument roept de IDBCreateCommand::CreateCommand-methode aan tijdens de sessie om een commandoobject te krijgen dat de ICommandText-interface op het commandoobject aanvraagt. Deze ICommandText-interface stelt de daadwerkelijke commandotekst in en haalt deze op. De consument vult het tekstcommando in door de ICommandText::SetCommandText-methode aan te roepen.

    2. De gebruiker roept de ICommand::Execute-methode aan op het commando. Het rowset-object dat wordt gebouwd wanneer het commando wordt uitgevoerd, bevat de resultaatset van het commando.

De consument kan de ICommandProperties-interface gebruiken om de eigenschappen te verkrijgen of in te stellen voor de rijset die wordt teruggegeven door het commando uitgevoerd door de ICommand::Execute-interfaces . De meest gevraagde eigenschappen zijn de interfaces die de rijset moet ondersteunen. Naast interfaces kan de consument eigenschappen aanvragen die het gedrag van de rowset of interface wijzigen.

Consumenten geven rijsets vrij met de IRowset::Release-methode . Het vrijgeven van een rowset laat alle rijhandvatten van de consument op die rowset vrij. Het loslaten van een rowset maakt de accessors niet vrij. Als je een IAccessor-interface hebt, moet die nog steeds worden vrijgegeven.

In deze sectie

Zie ook

OLE DB-stuurprogramma voor SQL Server-programmering