Share via


Bookmark.InsertDatabase Méthode

Définition

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.

S’applique à