Set di righe
Le righe di un set di righe contengono colonne di dati. I set di righe sono oggetti centrali che consentono a tutti i provider di dati OLE DB di esporre dati di set di risultati in formato tabulare.
Dopo aver creato una sessione mediante il metodo IDBCreateSession::CreateSession, il consumer può utilizzare l'interfaccia IOpenRowset o IDBCreateCommand nella sessione per creare un set di righe. Il provider OLE DB di SQL Server Native Client supporta entrambe le interfacce. Di seguito sono descritti i due metodi.
Creare un set di righe chiamando il metodo IOpenRowset::OpenRowset.
Questo metodo equivale a chiamare un set di righe in una singola tabella e consente di aprire e restituire un set di righe che include tutte le righe di una singola tabella di base. Uno degli argomenti di OpenRowset è un ID di tabella che identifica la tabella dalla quale creare il set di righe.
Creare un oggetto comando chiamando il metodo IDBCreateCommand::CreateCommand.
L'oggetto comando esegue comandi supportati dal provider. Con il provider OLE DB di SQL Server Native Client, il consumer può specificare qualsiasi istruzione Transact-SQL, ad esempio un'istruzione SELECT o una chiamata a una stored procedure. Di seguito sono elencati i passaggi per la creazione di un set di righe tramite un oggetto comando:
Il consumer chiama il metodo IDBCreateCommand::CreateCommand nella sessione per ottenere un oggetto comando che richieda l'interfaccia ICommandText sull'oggetto stesso. Questa interfaccia ICommandText imposta e recupera il testo del comando effettivo. Il consumer inserisce il comando di testo chiamando il metodo ICommandText::SetCommandText.
L'utente chiama il metodo ICommand::Execute sul comando. L'oggetto set di righe compilato durante l'esecuzione del comando contiene il set di risultati restituito dal comando.
Nel consumer può essere utilizzata l'interfaccia ICommandProperties per ottenere o impostare le proprietà per il set di righe restituito dal comando eseguito dalle interfacce ICommand::Execute. Le proprietà generalmente più richieste sono le interfacce che il set di righe deve supportare. Oltre alle interfacce, il consumer può richiedere proprietà che modificano il comportamento del set di righe o dell'interfaccia.
I consumer rilasciano set di righe con il metodo IRowset::Release. Il rilascio di un set di righe comporta anche il rilascio di tutti gli handle di riga gestiti dal consumer per tale set di righe, ma non comporta il rilascio delle funzioni di accesso. Se si dispone di un'interfaccia IAccessor, anche questa deve essere rilasciata.