Bookmark.InsertDatabase, méthode
Récupère des données d'une source de données (par exemple, un document Microsoft Office Word séparé, une feuille de calcul Microsoft Office Excel ou une base de données Microsoft Access) et insère les données en tant que tableau en remplacement du contrôle Bookmark.
Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)
Syntaxe
'Déclaration
Sub InsertDatabase ( _
ByRef Format As Object, _
ByRef Style As Object, _
ByRef LinkToSource As Object, _
ByRef Connection As Object, _
ByRef SQLStatement As Object, _
ByRef SQLStatement1 As Object, _
ByRef PasswordDocument As Object, _
ByRef PasswordTemplate As Object, _
ByRef WritePasswordDocument As Object, _
ByRef WritePasswordTemplate As Object, _
ByRef DataSource As Object, _
ByRef From As Object, _
ByRef To As Object, _
ByRef IncludeFields As Object _
)
void InsertDatabase(
ref Object Format,
ref Object Style,
ref Object LinkToSource,
ref Object Connection,
ref Object SQLStatement,
ref Object SQLStatement1,
ref Object PasswordDocument,
ref Object PasswordTemplate,
ref Object WritePasswordDocument,
ref Object WritePasswordTemplate,
ref Object DataSource,
ref Object From,
ref Object To,
ref Object IncludeFields
)
Paramètres
- Format
Type : System.Object%
Format répertorié dans la zone Formats de la boîte de dialogue Mise en forme automatique de tableau.Il peut s'agir de l'une des constantes WdTableFormat.Une bordure est appliquée par défaut aux cellules du tableau.
- Style
Type : System.Object%
Attributs du format automatique spécifiés par Format et appliqués au tableau.Utilisez la somme de toute combinaison des valeurs suivantes :
[1|1] Valeur
[1|2] Signification
[2|1] 0 (zéro)
[2|2] Aucun
[3|1] 1
[3|2] Bordures
[4|1] 2
[4|2] Trame de fond
[5|1] 4
[5|2] Font
[6|1] 8
[6|2] Couleur
[7|1] 16
[7|2] Ajustement automatique
[8|1] 32
[8|2] Aux lignes de titre
[9|1] 64
[9|2] À la dernière ligne
[10|1] 128
[10|2] À la première colonne
[11|1] 256
[11|2] À la dernière colonne
- LinkToSource
Type : System.Object%
true pour établir un lien entre le nouveau tableau et la source de données.
- Connection
Type : System.Object%
Plage dans laquelle exécuter la requête spécifiée par SQLStatement.La façon dont vous spécifiez la plage dépend de la façon dont les données sont récupérées.Par exemple :
Si vous récupérez des données par ODBC (Open Database Connectivity), vous spécifiez une chaîne de connexion.
Si vous récupérez des données de Microsoft Office Excel par échange dynamique de données (DDE, Dynamic Data Exchange), vous spécifiez une plage nommée ou une « feuille de calcul entière ».
Remarque L'échange dynamique de données (DDE, Dynamic Data Exchange) est une technologie plus ancienne, moins sûre.Si possible, utilisez une alternative plus fiable, telle que la liaison et l'incorporation d'objets (OLE, Object Linking and Embedding).
Si vous récupérez des données de Microsoft Access, vous spécifiez le mot « Table » ou « Requête » suivi du nom d'une table ou d'une requête.
- SQLStatement
Type : System.Object%
Chaîne de requête facultative qui récupère d'une source de données principale un sous-ensemble de données à insérer dans le document.
- SQLStatement1
Type : System.Object%
Si la chaîne de requête dépasse 255 caractères, SQLStatement représente la première partie de la chaîne et SQLStatement1 la deuxième partie.
- PasswordDocument
Type : System.Object%
Mot de passe (s'il y a lieu) requis pour ouvrir la source de données. (Consultez les notes ci-dessous.)
- PasswordTemplate
Type : System.Object%
Si la source de données est un document Microsoft Office Word, cet argument est le mot de passe (s'il y a lieu) requis pour ouvrir le modèle associé. (Consultez les notes ci-dessous.)
- WritePasswordDocument
Type : System.Object%
Mot de passe requis pour enregistrer des modifications apportées au document. (Consultez les notes ci-dessous.)
- WritePasswordTemplate
Type : System.Object%
Mot de passe requis pour enregistrer les modifications apportées au modèle. (Consultez les notes ci-dessous.)
- DataSource
Type : System.Object%
Chemin d'accès et nom du fichier de la source de données.
- From
Type : System.Object%
Numéro du premier enregistrement de données dans la plage d'enregistrements à insérer.
- To
Type : System.Object%
Numéro du dernier enregistrement de données dans la plage d'enregistrements à insérer.
- IncludeFields
Type : System.Object%
true pour inclure des noms de champs issus de la source de données dans la première ligne du nouveau tableau.
Notes
É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.
Évitez d'utiliser le compte d'ouverture de session de l'administrateur système (sa) intégré. À la place, faites des administrateurs système des membres du rôle serveur fixe sysadmin et faites en sorte qu'ils utilisent leurs propres comptes pour ouvrir une session. N'utilisez sa que s'il n'y a aucun autre moyen de se connecter. Pour empêcher un accès non autorisé par le compte d'ouverture de session sa, assignez à ce compte un mot de passe unique et inviolable.
Lorsque que c'est possible, utilisez l'authentification Windows (également connue en tant que connexion approuvée) qui utilise un compte d'utilisateur Windows pour les connexions à SQL Server. Lorsqu'un utilisateur se connecte par un compte d'utilisateur Windows, SQL Server utilise les informations du système d'exploitation Windows pour valider le nom du compte et le mot de passe. Avant de pouvoir utiliser l'authentification Windows, un administrateur du serveur doit configurer SQL Server de manière à utiliser ce mode d'authentification. Si l'authentification Windows n'est pas disponible, évitez d'enregistrer les informations sur les ouvertures de session des utilisateurs. Une plus grande sécurité est assurée si les utilisateurs entrent leurs informations d'ouverture de session chaque fois qu'ils se connectent.
Paramètres optionnels
Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.
Exemples
Cet exemple insère une feuille de calcul Microsoft Excel dans le contrôle Bookmark. La valeur Style (191) est une combinaison des nombres 1, 2, 4, 8, 16, 32 et 128. Cet exemple suppose que vous avez un classeur nommé Data.xlsx enregistré à la racine du répertoire C avec au moins deux lignes de données dans la feuille de calcul.
Cet exemple illustre une personnalisation au niveau du document.
Private Sub BookmarkInsertDatabase()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
Bookmark1.Text = "This is sample bookmark text"
Bookmark1.InsertDatabase(Format:=Word.WdTableFormat _
.wdTableFormatClassic1, Style:=191, LinkToSource:=False, _
Connection:="Entire Spreadsheet", DataSource:="C:\Data.xlsx")
End Sub
private void BookmarkInsertDatabase()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Bookmark bookmark1 =
this.Controls.AddBookmark(this.Paragraphs[1].Range,
"bookmark1");
bookmark1.Text = "This is sample bookmark text";
object Format = Word.WdTableFormat.wdTableFormatClassic1;
object Style = 191;
object LinkToSource = false;
object Connection = "Entire Spreadsheet";
object DataSource = "C:\\Data.xlsx";
bookmark1.InsertDatabase(ref Format, ref Style, ref LinkToSource,
ref Connection, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref DataSource,
ref missing, ref missing, ref missing);
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.