CreateRecordset, méthode (RDS)
S’applique à : Access 2013, Office 2013
Crée un objet Recordset vide et déconnecté.
Syntaxe
objet . CreateRecordset(ColumnInfos)
Paramètres
Paramètre | Description |
---|---|
Object | Variable objet représentant un objet RDSServer.DataFactory ou RDS.DataControl. |
ColumnsInfos | Tableau de type Variant qui contient des attributs et définit chaque colonne de l'objet Recordset créé. Chaque définition de colonne contient un tableau de quatre attributs obligatoires et un attribut facultatif. Le jeu de tableaux de colonnes est ensuite regroupé dans un tableau qui définit l'objet Recordset. Pour obtenir la liste des attributs, consultez le tableau suivant. |
Attributs de tableau de variantes
Attribut | Description |
---|---|
Nom | Nom de l'en-tête de colonne. |
Type | Entier du type de données. |
Taille | Entier de la largeur en caractères, quel que soit le type de données. |
Possibilité de valeur Null | Valeur de type Boolean. |
Mise à l’échelle (facultatif) | Cet attribut facultatif définit l'échelle des champs numériques. Si cette valeur n'est pas spécifiée, les valeurs numériques sont tronquées à une échelle de trois. La précision n'est pas affectée, mais le nombre de chiffres après la virgule est tronqué après trois. |
Remarques
L'objet métier côté serveur peut remplir l'objet Recordset résultant avec des données provenant d'un fournisseur de données non OLE DB, tel qu'un fichier du système d'exploitation contenant les cours des actions.
Le tableau suivant répertorie les valeurs de l'énumération DataTypeEnum prises en charge par la méthode CreateRecordset. Le nombre indiqué correspond au numéro de référence utilisé pour définir des champs.
Chaque type de données est de longueur fixe ou variable. Les types de longueur fixe doivent être définis par la taille –1, parce que la taille est prédéterminée et que la définition de la taille est toujours obligatoire. Les types de données de longueur variable permettent d'obtenir une taille situé entre 1 et 32767.
Pour certains types de données variables, il est possible de forcer une conversion du type dans le type indiqué dans la colonne Substitution. Vous ne voyez les substitutions qu'une fois l'objet Recordset créé et rempli. Vous pouvez alors vérifier le type de données réel, le cas échéant.
Longueur |
Constante |
Nombre |
Substitution |
---|---|---|---|
Fixed |
adTinyInt |
16 |
|
Fixed |
adSmallInt |
2 |
|
Fixed |
adInteger |
3 |
|
Fixed |
adBigInt |
20 |
|
Fixed |
adUnsignedTinyInt |
17 |
|
Fixed |
adUnsignedSmallInt |
18 |
|
Fixed |
adUnsignedInt |
19 |
|
Fixed |
adUnsignedBigInt |
21 |
|
Fixed |
adSingle |
4 |
|
Fixed |
adDouble |
5 |
|
Fixed |
adCurrency |
6 |
|
Fixed |
adDecimal |
14 |
|
Fixed |
adNumeric |
131 |
|
Fixed |
adBoolean |
11 |
|
Fixed |
adError |
10 |
|
Fixed |
adGuid |
72 |
|
Fixed |
adDate |
7 |
|
Fixed |
adDBDate |
133 |
|
Fixed |
adDBTime |
134 |
|
Fixed |
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 |