Partager via


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 à

Voir aussi

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