Metodo Bookmark.InsertDatabase
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.
Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Sintassi
'Dichiarazione
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
)
Parametri
- Format
Tipo: System.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
Tipo: System.Object%
Attributi di formattazione automatica specificati da Format applicati alla tabella.Utilizzare la somma di una qualsiasi combinazione dei valori seguenti:
[1|1] Valore
[1|2] Significato
[2|1] 0 (zero)
[2|2] Nessuno
[3|1] 1
[3|2] Bordi
[4|1] 2
[4|2] Sfondo
[5|1] 4
[5|2] Tipo di carattere
[6|1] 8
[6|2] Colore
[7|1] 16
[7|2] Adatta
[8|1] 32
[8|2] Righe del titolo
[9|1] 64
[9|2] Ultima riga
[10|1] 128
[10|2] Prima colonna
[11|1] 256
[11|2] Ultima colonna
- LinkToSource
Tipo: System.Object%
true per stabilire un collegamento tra la nuova tabella e l'origine dati.
- Connection
Tipo: System.Object%
Intervallo al cui interno 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 i dati vengono recuperati attraverso ODBC (Open Database Connectivity), viene specificata una stringa di connessione.
Quando i dati vengono recuperati da Microsoft Office Excel mediante DDE (Dynamic Data Exchange), viene specificato un intervallo denominato o "Intero foglio di calcolo".
Nota DDE rappresenta una tecnologia meno recente non sicura.Se possibile, utilizzare un'alternativa a DDE più sicura quale OLE (Object Linking and Embedding).
Quando i dati vengono recuperati da Microsoft Access, viene specificata la parola "Tabella" o "Query" seguita dal nome di una tabella o di una query.
- SQLStatement
Tipo: System.Object%
Stringa di query facoltativa che recupera un sottoinsieme dei dati contenuti in un'origine dati primaria da inserire nel documento.
- SQLStatement1
Tipo: System.Object%
Se la stringa di query è più lunga di 255 caratteri, SQLStatement indicherà la prima parte della stringa e SQLStatement1 la seconda parte.
- PasswordDocument
Tipo: System.Object%
Password richiesta, se disponibile, per aprire l'origine dati Vedere la sezione Osservazioni riportata di seguito.
- PasswordTemplate
Tipo: System.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
Tipo: System.Object%
Password richiesta per salvare le modifiche apportate al documento Vedere la sezione Osservazioni riportata di seguito.
- WritePasswordTemplate
Tipo: System.Object%
Password richiesta per salvare le modifiche apportate al modello Vedere la sezione Osservazioni riportata di seguito.
- DataSource
Tipo: System.Object%
Percorso e nome di file dell'origine dati.
- From
Tipo: System.Object%
Numero del primo record di dati nell'intervallo di record da inserire.
- To
Tipo: System.Object%
Numero dell'ultimo record di dati nell'intervallo di record da inserire.
- IncludeFields
Tipo: System.Object%
true per includere i nomi dei campi dell'origine dati nella prima riga della nuova tabella.
Note
Evitare l'utilizzo di password hardcoded nelle applicazioni. Se per una procedura è richiesta una password, richiederla all'utente, archiviarla in una variabile e utilizzare tale variabile nel codice.
Evitare l'utilizzo dell'account di accesso dell'amministratore di sistema (SA) incorporato. Includere piuttosto gli amministratori di sistema tra i membri del ruolo predefinito del server sysadmin e fare in modo che utilizzino i propri account per l'accesso. Utilizzare SA solo quando non esiste un altro modo per accedere. Per impedire l'accesso non autorizzato attraverso l'account SA, è necessario assegnare a tale account una password univoca e sicura.
Quando possibile, utilizzare l'autenticazione di Windows (nota anche come connessione trusted) che utilizza un account utente di Windows per connettersi a SQL Server. Quando un utente si connette attraverso un account utente di Windows, SQL Server utilizzerà le informazioni presenti nel sistema operativo Windows per convalidare il nome account e la password. Prima di poter utilizzare l'autenticazione di Windows, è necessario che un amministratore del server configuri SQL Server per l'utilizzo di questa modalità di autenticazione. Se l'autenticazione di Windows non è disponibile, evitare di salvare le informazioni di accesso degli utenti. Per gli utenti è più sicuro inserire le proprie informazioni di accesso ogni volta che effettuano l'accesso.
Parametri facoltativi
Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.
Esempi
In questo esempio viene inserito un foglio di calcolo di Microsoft Excel nel controllo Bookmark. Il valore Style (191) è una combinazione dei numeri 1, 2, 4, 8, 16, 32 e 128. Nell'esempio si presuppone che si disponga di 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 è valido per una personalizzazione a livello di documento.
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);
}
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.