Range.InsertDatabase, méthode (Word)

  • Article

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.