Nota
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare ad accedere o a cambiare directory.
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare a cambiare directory.
Un set di righe è un set di righe che contengono colonne di dati. I set di righe sono oggetti centrali che consentono a tutti i provider di dati OLE DB di esporre i dati del set di risultati in formato tabulare.
Dopo che un consumer crea una sessione usando il metodo IDBCreateSession::CreateSession , il consumer può usare l'interfaccia IOpenRowset o IDBCreateCommand nella sessione per creare un set di righe. Il provider OLE DB di SQL Server Native Client supporta entrambe queste interfacce. Entrambi questi metodi sono descritti qui.
Creare un set di righe chiamando il metodo IOpenRowset::OpenRowset .
Equivale alla creazione di un set di righe su una singola tabella. Questo metodo si apre e restituisce un set di righe che include tutte le righe di una singola tabella di base. Uno degli argomenti di OpenRowset è un ID tabella che identifica la tabella da cui creare il set di righe.
Creare un oggetto comando chiamando il metodo IDBCreateCommand::CreateCommand .
L'oggetto comando esegue i 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. I passaggi per la creazione di un set di righe tramite un oggetto comando sono i seguenti:
Il consumer chiama il metodo IDBCreateCommand::CreateCommand nella sessione per ottenere un oggetto comando che richiede l'interfaccia ICommandText nell'oggetto comando. Questa interfaccia ICommandText imposta e recupera il testo effettivo del comando. Il consumer compila il comando di testo chiamando il metodo ICommandText::SetCommandText .
L'utente chiama il metodo ICommand::Execute nel comando . L'oggetto set di righe compilato quando il comando esegue contiene il set di risultati del comando .
Il consumer può utilizzare l'interfaccia ICommandProperties per ottenere o impostare le proprietà per il set di righe restituito dal comando eseguito dalle interfacce ICommand::Execute . Le proprietà più comunemente 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 rilascia tutti gli handle di riga contenuti dal consumer in tale set di righe. Il rilascio di un set di righe non rilascia le funzioni di accesso. Se si dispone di un'interfaccia IAccessor , deve comunque essere rilasciata.