Recordset e DataTables
Un recordset è un oggetto Automation che è una tabella a dimensione fissa, delimitata o non associata che contiene righe semplici di dichiarazioni di dati host (tipi di dati). Una tabella dati è un oggetto .NET identico a un recordset, ad eccezione del fatto che non è possibile utilizzare la funzione NewRecordset con tabelle dati. Dopo aver creato un recordset o un oggetto datatable, è possibile chiamare metodi su tale oggetto per ottenere l'accesso alle righe.
Un recordset o una tabella dati viene implementato sopra i set di righe da Remote Data Service (RDS), che fa parte di Microsoft Data Access Components (MDAC) versione 2.5. È possibile utilizzare l'oggetto RDSServer.DataFactory per creare un recordset o una tabella dati e utilizzare ActiveX® Data Objects (ADO) per aggiornare o leggere il recordset.
Un recordset o una tabella dati consente di presentare e modificare dati tabulari. Attualmente, i recordset non possono essere annidati, non possono contenere matrici e non possono contenere tipi definiti dall'utente .
Il supporto per recordset e databales consente a TI di supportare in modo efficace una matrice di una struttura (o un record, nella terminologia COBOL) e una struttura. Una struttura è rappresentata come recordset a dimensione fissa o tabella dati in cui ogni colonna della riga contiene un singolo elemento dati. Per gestire i problemi di programmazione del mainframe, TI classifica i recordset e le tabelle dati come dimensioni fisse, delimitate o non associate, in riferimento al numero di righe contenute nel recordset o nella tabella dati.
Importante
Il modello di programmazione IBM i distributed program calls (DPC) supporta solo recordset di dimensioni fisse e tabelle dati. Il modello di programmazione non supporta recordset e tabelle dati senza vincoli, né supporta l'uso della clausola OCCURS DEPENDING ON o recordset e tabelle dati di dimensioni variabili.
Per recordset e tabelle dati TI di dimensioni fisse, delimitati e non associati, il layout di tutte le righe in un determinato recordset è lo stesso e viene definito in fase di progettazione tramite TI Project. Se un recordset o una tabella dati è un valore di output o restituito dal mainframe, l'ambiente di runtime TI utilizza l'oggetto RDSServer.DataFactory per creare un recordset o una tabella dati e ADO per riempire il recordset o la tabella dati con le righe di dati restituite dal programma mainframe.
Un recordset di questo tipo è un recordset disconnesso con un tipo di cursore adOpenForwardOnly. Per analizzare il recordset, è necessario chiamare MoveFirst e MoveNext per spostarsi tra le righe. Il recordset può essere aggiornato sul posto, ma poiché è disconnesso dall'origine dati true (l'origine dati modificata dal programma mainframe che ha restituito i dati), gli aggiornamenti non vengono propagati all'origine dati originale.
NewRecordset è una funzione fornita automaticamente per tutti i componenti TI. Questa funzione viene chiamata per creare un oggetto recordset disconnesso che può essere passato a una chiamata al metodo TI. NewRecordset viene fornito per praticità per le applicazioni client TI; non è necessario passare un recordset ai metodi di un componente TI. La funzione può essere chiamata solo per gli oggetti recordset di input o di input/output. L'ambiente di runtime TI crea un oggetto recordset quando il parametro è un oggetto recordset di output.