CreateRecordset-Methode (RDS)
Erstellt ein leeres, getrenntes Recordset.
Wichtig
Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.
Syntax
object.CreateRecordset(ColumnInfos)
Parameter
Object
Eine Objektvariable, die ein RDSServer.DataFactory- oder RDS.DataControl-Objekt darstellt.
ColumnsInfos
Ein Variant-Array von Attributen, das jede Spalte im erstellten Recordset definiert. Jede Spaltendefinition enthält ein Array mit vier erforderlichen und einem optionalen Attribut.
| attribute | BESCHREIBUNG |
|---|---|
| Name | Name des Spaltenheaders. |
| type | Ganze Zahl des Datentyps. |
| Size | Ganze Zahl der Breite in Zeichen, unabhängig vom Datentyp. |
| NULL-Zulässigkeit | Boolescher Wert. |
| Scale (optional) | Dieses optionale Attribut definiert die Skala für numerische Felder. Wenn dieser Wert nicht angegeben ist, werden numerische Werte auf eine Skala von drei abgeschnitten. Die Genauigkeit ist davon nicht betroffen, aber die Anzahl der Ziffern nach dem Dezimalpunkt wird auf drei gekürzt. |
Der Satz von Spaltenarrays wird dann in ein Array gruppiert, das das Recordset definiert.
Bemerkungen
Das serverseitige Geschäftsobjekt kann das resultierende Recordset mit Daten aus einem Nicht-OLE DB-Datenanbieter auffüllen, z. B. einer Betriebssystemdatei, die Aktienkurse enthält.
In der folgenden Tabelle sind die DataTypeEnum-Werte aufgeführt, die von der CreateRecordset-Methode unterstützt werden. Die aufgelistete Zahl ist die Referenznummer, die zum Definieren von Feldern verwendet wird.
Jeder der Datentypen ist hat entweder eine feste Länge oder eine variable Länge. Typen mit fester Länge sollten mit einer Größe von -1 definiert werden, da die Größe vorbestimmt und eine Größendefinition weiterhin erforderlich ist. Datentypen mit variabler Länge ermöglichen eine Größe von 1 bis 32767.
Für einige der Variablendatentypen kann der Typ zwangsweise auf den Typ festgelegt werden, der in der Spalte „Substitution“ (Ersetzung) angegeben ist. Die Ersetzungen werden erst angezeigt, nachdem das Recordset erstellt und aufgefüllt wurde. Anschließend können Sie bei Bedarf den tatsächlichen Datentyp überprüfen.
| Länge | Dauerhaft | Number | Substitution |
|---|---|---|---|
| Fest | adTinyInt | 16 | |
| Fest | adSmallInt | 2 | |
| Fest | adInteger | 3 | |
| Fest | adBigInt | 20 | |
| Fest | adUnsignedTinyInt | 17 | |
| Fest | adUnsignedSmallInt | 18 | |
| Fest | adUnsignedInt | 19 | |
| Fest | adUnsignedBigInt | 21 | |
| Fest | adSingle | 4 | |
| Fest | adDouble | 5 | |
| Fest | adCurrency | 6 | |
| Fest | adDecimal | 14 | |
| Fest | adNumeric | 131 | |
| Fest | adBoolean | 11 | |
| Fest | adError | 10 | |
| Fest | adGuid | 72 | |
| Fest | adDate | 7 | |
| Fest | adDBDate | 133 | |
| Fest | adDBTime | 134 | |
| Fest | adDBTimestamp | 135 | 7 |
| Variable | adBSTR | 8 | 130 |
| Variable | adChar | 129 | 200 |
| Variable | adVarChar | 200 | |
| Variable | adLongVarChar | 201 | 200 |
| Variable | adWChar | 130 | |
| Variable | adVarWChar | 202 | 130 |
| Variable | adLongVarWChar | 203 | 130 |
| Variable | adBinary | 128 | |
| Variable | adVarBinary | 204 | |
| Variable | adLongVarBinary | 205 | 204 |
Gilt für
Weitere Informationen
CreateRecordset-Methode – Beispiel (VB)
CreateRecordset-Methode – Beispiel (VBScript)
CreateObject-Methode (RDS)