Bookmark.InsertDatabase Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
public 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);
abstract member InsertDatabase : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit
Public Sub InsertDatabase (Optional ByRef Format As Object, Optional ByRef Style As Object, Optional ByRef LinkToSource As Object, Optional ByRef Connection As Object, Optional ByRef SQLStatement As Object, Optional ByRef SQLStatement1 As Object, Optional ByRef PasswordDocument As Object, Optional ByRef PasswordTemplate As Object, Optional ByRef WritePasswordDocument As Object, Optional ByRef WritePasswordTemplate As Object, Optional ByRef DataSource As Object, Optional ByRef From As Object, Optional ByRef To As Object, Optional ByRef IncludeFields As Object)
Paramètres
- Format
- 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
- Object
Attributs de la mise en forme automatique spécifiée par Format
qui sont appliqués à la table. Utilisez la somme de toute combinaison des valeurs suivantes :[1|1] Valeur[1|2] Signification[2|1] 0 (zéro)[2|2] None[3|1] 1[3|2] Bordures[4|1] 2[4|2] Trame de fond[5|1] 4[5|2] Police[6|1] 8[6|2] Couleur[7|1] 16[7|2] Ajustement automatique[8|1] 32[8|2] Lignes de titre[9|1] 64[9|2] Dernière ligne[10|1] 128[10|2] Première colonne[ 11|1] 256[11|2] Dernière colonne
- LinkToSource
- Object
true
pour établir un lien entre le nouveau tableau et la source de données.
- Connection
- Object
Plage dans laquelle effectuer 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 : lors de la récupération de données via ODBC (Open Database Connectivity), vous spécifiez une chaîne de connexion. Lorsque vous récupérez des données à partir de Microsoft Office Excel à l’aide de l’échange dynamique de données (DDE), vous spécifiez une plage nommée ou « Feuille de calcul entière ». Remarque
L’échange dynamique de données (DDE) est une technologie plus ancienne qui n’est pas sécurisée. Si possible, utilisez une alternative plus sécurisée à DDE, telle que la liaison d’objets et l’incorporation (OLE). Lorsque vous récupérez des données à partir de Microsoft Access, vous spécifiez le mot « Table » ou « Requête » suivi du nom d’une table ou d’une requête.
- SQLStatement
- 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
- Object
Si la chaîne de requête contient plus de 255 caractères, SQLStatement
indique la première partie de la chaîne et SQLStatement1
la deuxième partie.
- PasswordDocument
- Object
Mot de passe (s'il y a lieu) requis pour ouvrir la source de données. (Consultez les notes ci-dessous.)
- PasswordTemplate
- 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
- Object
Mot de passe requis pour enregistrer des modifications apportées au document. (Consultez les notes ci-dessous.)
- WritePasswordTemplate
- Object
Mot de passe requis pour enregistrer les modifications apportées au modèle. (Consultez les notes ci-dessous.)
- DataSource
- Object
Chemin d'accès et nom du fichier de la source de données.
- From
- Object
Numéro du premier enregistrement de données dans la plage d'enregistrements à insérer.
- To
- Object
Numéro du dernier enregistrement de données dans la plage d'enregistrements à insérer.
- IncludeFields
- Object
true
pour inclure des noms de champs issus de la source de données dans la première ligne du nouveau tableau.
Exemples
Cet exemple montre comment insérer une feuille de calcul Microsoft Excel dans le Bookmark contrôle . La valeur style (191) est une combinaison des nombres 1, 2, 4, 8, 16, 32 et 128. Cet exemple suppose que vous disposez d’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 concerne une personnalisation au niveau du document.
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);
}
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
Remarques
É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 mot de passe à l’utilisateur, stockez-le dans une variable, puis utilisez la variable dans votre code.
Évitez d’utiliser le compte d’ouverture de session d’administrateur système (SA) intégré. Au lieu de cela, faites en sorte que les administrateurs système soient membres du rôle serveur fixe sysadmin et qu’ils utilisent leurs propres comptes pour se connecter. Utilisez sa uniquement lorsqu’il n’existe aucun autre moyen de se connecter. Pour empêcher tout accès non autorisé via le compte d’ouverture de session sa, vous devez attribuer à ce compte un mot de passe fort et unique.
Dans la mesure du possible, utilisez l’authentification Windows (également appelée connexion approuvée), qui utilise un compte d’utilisateur Windows pour se connecter à SQL Server. Lorsqu’un utilisateur se connecte via un compte d’utilisateur Windows, SQL Server utilise les informations du système d’exploitation Windows pour valider le nom et le mot de passe du compte. Avant de pouvoir utiliser l’authentification Windows, un administrateur de serveur doit configurer SQL Server pour utiliser ce mode d’authentification. Si l’authentification Windows n’est pas disponible, évitez d’enregistrer les informations de connexion des utilisateurs. Il est plus sécurisé pour les utilisateurs d’entrer leurs informations de connexion chaque fois qu’ils se connectent.
Paramètres facultatifs
Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.