Range.InsertDatabase, méthode (Word)

Article
04/07/2023

Extrait des données à partir d'une source de données (par exemple, un autre document Microsoft Word, une feuille de calcul Microsoft Excel ou une base de données Microsoft Access) et insère les données sous forme de tableau à la place de la plage spécifiée.

Syntaxe

expression. InsertDatabase (Format, Style, LinkToSource, Connection, SQLStatement, SQLStatement1, PasswordDocument, PasswordTemplate, WritePasswordDocument, WritePasswordTemplate, DataSource, From, To, IncludeFields)

expression Obligatoire. Variable qui représente un objet Range.

Parameters

Nom	Requis/Facultatif	Type de données	Description
Format	Facultatif	Variant	Mise en forme répertoriée dans la zone Format de la boîte de dialogue Mise en forme automatique de tableau (menu Tableau). Peut être une des constantes WdTableFormat. Une bordure est appliquée aux cellules de la table par défaut.
Style	Facultatif	Variant	Attributs de la mise en forme automatique que l'argument Format spécifie et qui sont appliqués au tableau.
LinkToSource	Facultatif	Variant	True pour établir un lien entre le nouveau tableau et la source de données.
Connection	Facultatif	Variant	Plage dans laquelle effectuer la requête spécifiée par SQLStatement.
SQLStatement	Facultatif	String	Chaîne de requête facultative qui extrait un sous-ensemble des données d'une source principale en vue de les insérer dans le document.
SQLStatement1	Facultatif	String	Si la chaîne de requête comporte plus de 255 caractères, SQLStatement désigne la première partie de la chaîne et SQLStatement1 la deuxième.
PasswordDocument	Facultatif	Variant	Mot de passe éventuel requis pour ouvrir la source de données. (Voir les remarques ci-dessous.)
PasswordTemplate	Facultatif	Variant	Si la source de données est un document Word, cet argument est le mot de passe éventuel requis pour ouvrir le modèle associé. (Voir les remarques ci-dessous.)
WritePasswordDocument	Facultatif	Variant	Mot de passe requis pour enregistrer les modifications apportées au document. (Voir les remarques ci-dessous.)
WritePasswordTemplate	Facultatif	Variant	Mot de passe requis pour enregistrer les modifications apportées au modèle. (Voir les remarques ci-dessous.)
DataSource	Facultatif	Variant	Chemin d'accès et nom de la source de données.
From	Facultatif	Variant	Numéro du premier enregistrement de la plage à insérer.
To	Facultatif	Variant	Numéro du dernier enregistrement de la plage à insérer.
IncludeFields	Facultatif	Variant	True pour inclure les noms de champ de la source de données dans la première ligne du nouveau tableau.

Sécurité

Importante

Évitez d’utiliser des mots de passe codés en dur dans vos applications. Si un mot de passe est requis dans une procédure, demandez-le à l’utilisateur, stockez-le dans une variable, puis utilisez la variable dans votre code. Pour connaître les meilleures pratiques recommandées sur la façon de procéder, consultez Notes de sécurité pour les développeurs de solutions Office.

Remarques

La valeur de l'argument Style peut être la somme de toute combinaison des valeurs suivantes :

Valeur	Description
0 (zéro)	Note
1	Bordures
2	Trame de fond
4	Police
8	Couleur
16	Ajustement automatique
32	Lignes de titre
64	Dernière ligne
128	Première colonne
256	Dernière colonne

Vous définirez l'argument Connexion en fonction de la manière dont les données sont récupérées. Par exemple :

Si vous utilisez ODBC (Open Database Connectivity) pour extraire les données, spécifiez une chaîne de connexion.
Si l'échange dynamique de données (DDE) est utilisé pour l'extraction des donnés à partir d'Excel, indiquez une plage nommée ou une « feuille de calcul entière ».
Si les données sont extraites d'Access, spécifiez le mot « Table » ou « Requête » suivi du nom d'une table ou d'une requête.

Exemple

Cet exemple montre comment insérer après la sélection une feuille de calcul Excel appelée « Data.xls ». La valeur de Style (191) est une combinaison des nombres 1, 2, 4, 8, 16, 32 et 128.

With Selection 
    .Collapse Direction:=wdCollapseEnd 
    .Range.InsertDatabase _ 
        Format:=wdTableFormatSimple2, Style:=191, _ 
        LinkToSource:=False, Connection:="Entire Spreadsheet", _ 
        DataSource:="C:\MSOffice\Excel\Data.xls" 
End With

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.

Partage via