Reshape Name, propriété dynamique (ADO)

Spécifie un nom pour l’objet Recordset.

Valeurs de retour

Retourne une valeur String qui est le nom de l’objet Recordset.

Notes

Les noms persistent pendant la durée de la connexion ou jusqu’à ce que l’objet Recordset soit fermé.

La propriété Reshape Name est principalement destinée à être utilisée avec la fonctionnalité de nouvelle mise en forme du fournisseur de services Service de mise en forme de données Microsoft pour OLE DB. Les noms doivent être uniques pour participer à la nouvelle mise en forme.

Cette propriété est en lecture seule, mais peut être définie indirectement lorsqu’un Recordset est créé. Par exemple, si une clause d’une commande Shape crée un Recordset et lui donne un nom d’alias à l’aide du mot clé AS, l’alias est affecté à la propriété Reshape Name. Si aucun alias n’est déclaré, la propriété Reshape Name reçoit un nom unique généré par le service de mise en forme des données. Si le nom de l’alias est identique au nom d’un Recordset existant, aucun Recordset ne peut être remodelé jusqu’à ce que l’un d’eux soit libéré. Le comportement par défaut peut être modifié en définissant un nom unique dans la propriété Reshape Name de la connexion ADO sur True. Si nécessaire, la définition de cette propriété autorise le service de mise en forme des données à modifier le nom attribué par l’utilisateur pour garantir l’unicité. Pour plus d’informations sur la réorganisation, consultez Microsoft Data Shaping Service pour OLE DB (fournisseur de services ADO).

Utilisez la propriété Reshape Name lorsque vous souhaitez faire référence à un Recordset dans une commande Shape, ou lorsque vous ne connaissez pas le nom, car il a été généré par le service de mise en forme des données. Dans ce cas, vous pouvez générer une commande SHAPE en concaténant la commande autour de la chaîne retournée par la propriété Reshape Name.

Reshape Name est une propriété dynamique ajoutée à la collection Properties de l’objet Recordset lorsque la propriété CursorLocation est définie sur adUseClient.

S'applique à

Recordset, objet (ADO)

Voir aussi

Microsoft Data Shaping Service pour OLE DB (fournisseur de services ADO)
Généralités sur les commandes SHAPE
Recordset, objet (ADO)