Partager via


propriété DataRecordset.Name (Visio)

Obtient ou définit le nom complet du jeu d'enregistrements de données. Lecture-écriture.

Remarque

Cet objet ou ce membre Visio est disponible uniquement pour les titulaires d’une licence d’utilisation de Visio Professionnel 2013.

Syntaxe

expression. Nom

expression Variable qui représente un objet DataRecordset .

Valeur renvoyée

String

Remarques

Le nom d’affichage d’un objet DataRecordset est le nom que vous avez passé en tant que paramètre Name à la méthode DataRecordsets.Add, DataRecordsets.AddFromConnectionFile ou DataRecordsets.AddFromXML lorsque vous avez créé le jeu d’enregistrements de données pour la première fois. ou le nom que vous avez affecté par la suite en définissant cette propriété. Si vous n’attribuez pas de nom lorsque vous créez un jeu d’enregistrements de données, Microsoft Visio attribue un nom par défaut, tel que Sheet1 , qui serait le nom attribué si vous avez importé des données à partir d’un classeur Microsoft Excel.

Si vous spécifiez (dans le paramètre AddOptions de l'une des méthodes Add) que la fenêtre Données externes doit apparaître dans l'interface utilisateur de Visio, le nom complet s'affiche sur l'onglet de la fenêtre Données externes qui correspond au jeu d'enregistrements de données.

La valeur de la propriété Name doit être unique au sein d'un document spécifique ; vous ne pouvez pas affecter le même nom complet à plus d'un jeu d'enregistrements de données. Si vous tentez d'affecter la valeur de propriété Name d'un jeu d'enregistrements de données existant à l'autre jeu d'enregistrements de données dans le même document, l'affectation échoue. Si vous ajoutez un nouveau jeu d'enregistrements de données à un document à l'aide de la méthode Add, et si vous transférez à la méthode Add le nom d'un jeu d'enregistrements de données existant en tant que nom complet, Visio applique un tiret et un nombre (-1, par exemple) au nom afin de le rendre unique dans le contexte du document.

Cependant, si vous supprimez un jeu d’enregistrements de données, vous pouvez réutiliser le nom complet du jeu d’enregistrements de données supprimé pour un autre jeu d’enregistrements de données dans le même document. Cela contraste avec le cas de la valeur de propriété DataRecordset.ID . Un ID particulier est unique pour la durée du document et vous ne pouvez pas le réutiliser, même si vous supprimez le jeu d’enregistrements de données auquel il a été affecté.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.