Partager via

Remodeler la propriété dynamique de nom (ADO)

  • Article

S’applique à : Access 2013, Office 2013

Spécifie un nom pour l'objet Recordset.

Valeurs de retour

Renvoie une valeur de type String qui représente le nom de l'objet Recordset.

Remarques

Les noms persistent pendant la durée de la connexion ou jusqu'à la fermeture de l'objet Recordset.

La propriété Reshape Name est principalement destinée à une utilisation avec la fonction de remise en forme du fournisseur de services Service de mise en forme des données pour OLE DB. Les noms doivent être uniques pour participer à la remise en forme.

Cette propriété est en lecture seule, mais elle peut être définie indirectement lorsqu'un objet Recordset est créé. Par exemple, si une clause d'une commande SHAPE crée un objet Recordset et lui donne un nom d'alias avec le mot clé « AS », l'alias est affecté à la propriété Reshape Name. Si aucun alias n'est déclaré, la propriété Reshape Name est affectée d'un nom unique généré par le service de mise en forme des données. Si le nom d'alias est identique au nom d'un objet Recordset existant, aucun des deux objets Recordset ne peut être mis en forme tant que l'un d'eux n'a pas été libéré. Le comportement par défaut peut être modifié en affectant à la propriété « Unique Reshape Names » (voir la section "Service de mise en forme des données Microsoft pour OLE DB ») de la connexion ADO la valeur TRUE. Le service de mise en forme des données peut alors modifier les noms affectés par l'utilisateur, si cela s'avère nécessaire pour des raisons d'unicité.

Utilisez la propriété Reshape Name lorsque vous souhaitez faire référence à un objet Recordset dans une commande SHAPE ou lorsque vous ignorez son 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 renvoyée par la propriété Reshape Name.

La propriété Reshape Name est une propriété dynamique ajoutée à la collection Properties de l'objet Recordset lorsque la propriété CursorLocation a la valeur adUseClient.