Bookmark.InsertDatabase Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Recupera dati da un'origine dati (ad esempio, un documento separato di Microsoft Office Word, un foglio di lavoro di Microsoft Office Excel o un database di Microsoft Access) e li inserisce in forma di tabella al posto del controllo 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)

Parametri

Format: Object

Formato elencato nella casella Formati della finestra di dialogo Formattazione automatica tabella. Può essere una delle costanti WdTableFormat. Per impostazione predefinita, viene applicato un bordo alle celle della tabella.

Style: Object

LinkToSource: Object

true per stabilire un collegamento tra la nuova tabella e l'origine dati.

Connection: Object

Intervallo all'interno del quale eseguire la query specificata da SQLStatement. Il modo in cui viene specificato l'intervallo dipende dal modo in cui vengono recuperati i dati. Ad esempio: quando si recuperano dati tramite ODBC (Open Database Connectivity), si specifica un stringa di connessione. Quando si recuperano dati da Microsoft Office Excel utilizzando DDE (Dynamic Data Exchange), si specifica un intervallo denominato o "Intero foglio di calcolo". Nota Lo scambio di dati dinamici (DDE) è una tecnologia meno recente che non è sicura. Se possibile, usare un'alternativa più sicura a DDE, ad esempio il collegamento e l'incorporamento di oggetti (OLE). Quando si recuperano dati da Microsoft Access, si specifica la parola "Table" o "Query" seguita dal nome di una tabella o di una query.

SQLStatement: Object

Stringa di query facoltativa che recupera un sottoinsieme dei dati contenuti in un'origine dati primaria da inserire nel documento.

SQLStatement1: Object

Se la stringa di query è più lunga di 255 caratteri, SQLStatement indica la prima parte della stringa e SQLStatement1 indica la seconda parte.

PasswordDocument: Object

Password richiesta, se disponibile, per aprire l'origine dati Vedere la sezione Osservazioni riportata di seguito.

PasswordTemplate: Object

Se l'origine dati è un documento di Microsoft Office Word, questo argomento rappresenterà la password richiesta, se disponibile, per aprire il modello collegato Vedere la sezione Osservazioni riportata di seguito.

WritePasswordDocument: Object

Password richiesta per salvare le modifiche apportate al documento Vedere la sezione Osservazioni riportata di seguito.

WritePasswordTemplate: Object

Password richiesta per salvare le modifiche apportate al modello Vedere la sezione Osservazioni riportata di seguito.

DataSource: Object

Percorso e nome di file dell'origine dati.

From: Object

Numero del primo record di dati nell'intervallo di record da inserire.

To: Object

Numero dell'ultimo record di dati nell'intervallo di record da inserire.

IncludeFields: Object

true per includere i nomi dei campi dell'origine dati nella prima riga della nuova tabella.

Esempio

In questo esempio viene inserito un foglio di calcolo di Microsoft Excel nel Bookmark controllo . Il valore Style (191) è una combinazione dei numeri 1, 2, 4, 8, 16, 32 e 128. In questo esempio si presuppone che sia presente una cartella di lavoro denominata Data.xlsx salvata nella radice della directory C con almeno due righe di dati nel foglio di lavoro.

Questo esempio è relativo a una personalizzazione a livello di documento.

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

Commenti

Evitare di usare password hardcoded nelle applicazioni. Se una password è necessaria in una procedura, richiedere la password all'utente, archiviarla in una variabile e quindi usare la variabile nel codice.

Evitare di usare l'account di accesso amministratore di sistema (sa) predefinito. Rendere invece membri amministratori di sistema del ruolo predefinito del server sysadmin e farli usare i propri account per accedere. Usare sa solo quando non esiste un altro modo per accedere. Per impedire l'accesso non autorizzato tramite l'account di accesso sa, è necessario assegnare all'account una password complessa e univoca.

Quando possibile, usare l'autenticazione di Windows (nota anche come connessione attendibile), che usa un account utente di Windows per connettersi a SQL Server. Quando un utente si connette tramite un account utente di Windows, SQL Server usa le informazioni nel sistema operativo Windows per convalidare il nome e la password dell'account. Prima di poter usare l'autenticazione di Windows, un amministratore del server deve configurare SQL Server per usare questa modalità di autenticazione. Se l'autenticazione di Windows non è disponibile, evitare di salvare le informazioni di accesso degli utenti. È più sicuro per gli utenti immettere le informazioni di accesso ogni volta che accedono.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.

Si applica a

Condividi tramite