CreateRecordset, méthode (RDS)

Crée un Recordset vide et déconnecté.

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir le Guide pratique sur la compatibilité de Windows Server 2012 et Windows 8 pour plus de détails). Les composants clients RDS seront supprimés dans une version ultérieure de Windows. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers WCF Data Service.

Syntaxe

  
object.CreateRecordset(ColumnInfos)  

Paramètres

Object
Variable d’objet qui représente un RDSServer.DataFactory ou un objet RDS.DataControl.

ColumnsInfos
Un tableau Variant d’attributs qui définit chaque colonne du Recordset créé. Chaque définition de colonne contient un tableau de quatre attributs requis et un attribut facultatif.

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 valeurs nulles	Valeur booléenne.
Mise à l’échelle (facultatif)	Cet attribut facultatif définit l’échelle pour les 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 suivant le point décimal sera tronqué à trois.

L’ensemble de tableaux de colonnes est ensuite regroupé dans un tableau, qui définit le Recordset.

Notes

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 de système d’exploitation contenant des guillemets.

Le tableau suivant répertorie les valeurs DataTypeEnum prises en charge par la méthode CreateRecordset. Le nombre répertorié est le numéro de référence utilisé pour définir des champs.

Chacun des types de données est de longueur fixe ou de longueur variable. Les types de longueur fixe doivent être définis avec une taille de -1, car la taille est prédéterminée et une définition de taille est toujours requise. Les types de données de longueur variable autorisent une taille comprise entre 1 et 32767.

Pour certains des types de données variables, le type peut être contraint au type noté dans la colonne Substitution. Vous ne verrez pas les substitutions tant que le Recordset n’est pas créé et rempli. Vous pouvez ensuite vérifier le type de données réel, si nécessaire.

Longueur	Constant	Number	Substitution
Fixe	adTinyInt	16
Fixe	adSmallInt	2
Fixe	adInteger	3
Fixe	adBigInt	20
Fixe	adUnsignedTinyInt	17
Fixe	adUnsignedSmallInt	18
Fixe	adUnsignedInt	19
Fixe	adUnsignedBigInt	21
Fixe	adSingle	4
Fixe	adDouble	5
Fixe	adCurrency	6
Fixe	adDecimal	14
Fixe	adNumeric	131
Fixe	adBoolean	11
Fixe	adError	10
Fixe	adGuid	72
Fixe	adDate	7
Fixe	adDBDate	133
Fixe	adDBTime	134
Fixe	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

S'applique à

DataControl, objet (RDS)

DataFactory, objet (RDSServer)

Voir aussi

CreateRecordset, exemple de méthode (VB)
CreateRecordset, exemple de méthode (VBScript)
CreateObject, méthode (RDS)