Rowsets

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-databas i Microsoft Fabric

Ladda ned OLE DB-drivrutins

En radmängd är en mängd rader som innehåller kolumner med data. Radmängder är centrala objekt som gör det möjligt för alla leverantörer av OLE DB-data att exponera resultatmängdsdata i tabellform.

Efter att en konsument skapat en session genom att använda metoden IDBCreateSession::CreateSession kan konsumenten använda antingen IOpenRowset- eller IDBCreateCommand-gränssnittet på sessionen för att skapa en raduppsättning. OLE DB-drivrutinen för SQL Server stöder båda dessa gränssnitt. Båda dessa metoder beskrivs här.

  • Skapa en radmängd genom att anropa metoden IOpenRowset::OpenRowset .

    Detta är ekvivalent med att skapa en radmängd över en enda tabell. Denna metod öppnar och returnerar en radmängd som inkluderar alla rader från en enda bastabell. Ett av argumenten till OpenRowset är ett tabell-ID som identifierar tabellen från vilken raduppsättningen ska skapas.

  • Skapa ett kommandoobjekt genom att anropa metoden IDBCreateCommand::CreateCommand .

    Kommandoobjektet utför kommandon som leverantören stödjer. Med OLE DB-drivrutinen för SQL Server kan konsumenten ange vilken Transact-SQL som helst, såsom en SELECT-sats eller ett anrop till en lagrad procedur. Stegen för att skapa en radmängd med hjälp av ett kommandoobjekt är:

    1. Konsumenten anropar metoden IDBCreateCommand::CreateCommand under sessionen för att hämta ett kommandoobjekt som begär ICommandText-gränssnittet på kommandoobjektet. Detta ICommandText-gränssnitt sätter och hämtar den faktiska kommandotexten. Konsumenten fyller i textkommandot genom att anropa ICommandText::SetCommandText-metoden .

    2. Användaren anropar metoden ICommand::Execute på kommandot. Rowset-objektet som byggs när kommandot körs innehåller resultatmängden från kommandot.

Konsumenten kan använda ICommandProperties-gränssnittet för att hämta eller sätta egenskaperna för radmängden som returneras av kommandot som utförs av ICommand::Exekver-gränssnitten . De vanligaste egenskaperna som efterfrågas är de gränssnitt som raduppsättningen måste stödja. Utöver gränssnitt kan konsumenten begära egenskaper som modifierar raduppsättningens eller gränssnittets beteende.

Konsumenter släpper raduppsättningar med metoden IRowset::Release . Att släppa en raduppsättning frigör alla radhandtag som konsumenten har på den raduppsättningen. Att släppa en raduppsättning frigör inte accessorerna. Om du har ett IAccessor-gränssnitt måste det ändå släppas.

I det här avsnittet

Se även

OLE DB-drivrutin för SQL Server Programming