Data.SqlExpr.TSQLDataSet
Delphi
TSQLDataSet = class(TCustomSQLDataSet)
C++
class PASCALIMPLEMENTATION TSQLDataSet : public TCustomSQLDataSet
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | Data.SqlExpr.pas Data.SqlExpr.hpp |
Data.SqlExpr | Data.SqlExpr |
Beschreibung
TSQLDataSet stellt Daten dar, die mit DBExpress abgerufen wurden.
TSQLDataSet ist eine vielseitig verwendbare, unidirektionale Datenmenge für den Zugriff auf Datenbankinformationen mit DBExpress. Sie können TSQLDataSet-Komponenten während des Entwurfs zu einem Formular oder Datenmodul hinzufügen oder zur Laufzeit dynamisch erstellen.
Mit TSQLDataSet können Sie:
- die Datensätze einer Datenbanktabelle, das Ergebnis einer SELECT-Abfrage oder die von einer Stored Procedure zurückgegebene Ergebnismenge darstellen.
- Abfragen oder Stored Procedures ausführen, die keine Ergebnismenge zurückgeben.
- Metadaten abrufen, die beschreiben, welche Elemente auf dem Datenbankserver verfügbar sind (Tabellen, Stored Procedures, Felder einer Tabelle usw.).
TSQLDataSet ist eine unidirektionale Datenmenge. Im Gegensatz zu herkömmlichen Datenmengen puffern unidirektionale Datenmengen keine Datensätze. Aus diesem Grund stehen für die Navigation nur die Methoden First und Next zur Verfügung. Es gibt keine integrierte Datenbearbeitung: Sie können die Daten einer SQL-Datenmenge nur bearbeiten, indem Sie explizit eine SQL-UPDATE-Anweisung verwenden oder die Datenmenge über einen Provider mit einer Client-Datenmenge verbinden. Funktionen, bei denen mehrere Datensätze in einem Puffer abgelegt werden müssen (z.B. Filter oder Lookup-Felder), werden nicht unterstützt.
Bevor eine TSQLDataSet-Komponente verwendet werden kann, muss sie mit dem Datenbankserver verbunden werden. Der erste Schritt bei der Arbeit mit TSQLDataSet besteht also immer darin, der Eigenschaft SQLConnection einen Wert zuzuweisen.
Sobald dies geschehen ist, weisen Sie der Eigenschaft CommandText mit Hilfe des Anweisungstexteditors einen Wert zu. Wenn Sie mit der Datenmenge eine Abfrage ausführen wollen, sind weitere Zuweisungen nicht erforderlich. Um eine Stored Procedure auszuführen oder eine bestimmte Datenbanktabelle vollständig abzurufen, setzen Sie die Eigenschaft CommandType und wählen den Namen der Tabelle oder Stored Procedure aus der Dropdown-Liste der Eigenschaft CommandText. Wenn Sie mit der SQL-Datenmenge auf Metadaten zugreifen möchten, müssen Sie die gewünschten Metadaten zur Laufzeit angeben, indem Sie die Methode SetSchemaInfo aufrufen.
DefaultRowsetSize ist 20 (DefaultRowsetSize = 20). Wenn Sie den Wert von RowSetSize für vorhandene Oracle-Datenbankverbindungen ändern möchten, fügen Sie zu dbxconnections.ini (Windows) bzw. dbxconnections.conf (Linux) die Eigenschaft RowSetSize manuell hinzu (z.B. RowsetSize = 200). Wenn die Eigenschaft RowSetSize in neue Verbindungen einbezogen werden soll, fügen Sie sie zu dbxdrivers.ini (Windows) bzw. dbxdrivers.conf (Linux) hinzu. RowsetSize kann auch im Code geändert werden (z.B. SQLConnection1.Params.Values['RowsetSize'] := '200'). Gegenwärtig wird diese Funktion nur von Oracle-Datenbanken unterstützt.