Range.InsertDatabase Method
Retrieves data from a data source (for example, a separate Microsoft Word document, a Microsoft Excel worksheet, or a Microsoft Access database) and inserts the data as a table in place of the specified range.
Namespace: Microsoft.Office.Interop.Word
Assembly: Microsoft.Office.Interop.Word (in Microsoft.Office.Interop.Word.dll)
Syntax
'Declaration
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 _
)
'Usage
Dim instance As Range
Dim Format As Object
Dim Style As Object
Dim LinkToSource As Object
Dim Connection As Object
Dim SQLStatement As Object
Dim SQLStatement1 As Object
Dim PasswordDocument As Object
Dim PasswordTemplate As Object
Dim WritePasswordDocument As Object
Dim WritePasswordTemplate As Object
Dim DataSource As Object
Dim From As Object
Dim To As Object
Dim IncludeFields As Object
instance.InsertDatabase(Format, Style, _
LinkToSource, Connection, SQLStatement, _
SQLStatement1, PasswordDocument, _
PasswordTemplate, WritePasswordDocument, _
WritePasswordTemplate, DataSource, _
From, To, IncludeFields)
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
)
Parameters
- Format
Type: System.Object%
Optional Object. A format listed in the Formats box in the Table AutoFormat dialog box (Table menu). Can be any of the WdTableFormat constants. A border is applied to the cells in the table by default.
- Style
Type: System.Object%
Optional Object. The attributes of the AutoFormat specified by Format that are applied to the table. Use the sum of any combination of the following values:
Value
Meaning
0 (zero)
None
1
Borders
2
Shading
4
Font
8
Color
16
Auto Fit
32
Heading Rows
64
Last Row
128
First Column
256
Last Column
- LinkToSource
Type: System.Object%
Optional Object. True to establish a link between the new table and the data source.
- Connection
Type: System.Object%
Optional Object. A range within which to perform the query specified by SQLStatement. How you specify the range depends on how data is retrieved. For example:
When retrieving data through Open Database Connectivity (ODBC), you specify a connection string.
When retrieving data from Microsoft Excel by using dynamic data exchange (DDE), you specify a named range or "Entire Spreadsheet."Security Dynamic data exchange (DDE) is an older technology that is not secure. If possible, use a more secure alternative to DDE.
When retrieving data from Microsoft Access, you specify the word "Table" or "Query" followed by the name of a table or query.
- SQLStatement
Type: System.Object%
Optional String. An optional query string that retrieves a subset of the data in a primary data source to be inserted into the document.
- SQLStatement1
Type: System.Object%
Optional String. If the query string is longer than 255 characters, SQLStatement denotes the first portion of the string and SQLStatement1 denotes the second portion.
- PasswordDocument
Type: System.Object%
Optional Object. The password (if any) required to open the data source. (See Remarks below.)
- PasswordTemplate
Type: System.Object%
Optional Object. If the data source is a Word document, this argument is the password (if any) required to open the attached template. (See Remarks below.)
- WritePasswordDocument
Type: System.Object%
Optional Object. The password required to save changes to the document. (See Remarks below.)
- WritePasswordTemplate
Type: System.Object%
Optional Object. The password required to save changes to the template. (See Remarks below.)
- DataSource
Type: System.Object%
Optional Object. The path and file name of the data source.
- From
Type: System.Object%
Optional Object. The number of the first data record in the range of records to be inserted.
- To
Type: System.Object%
Optional Object. The number of the last data record in the range of records to be inserted.
- IncludeFields
Type: System.Object%
Optional Object. True to include field names from the data source in the first row of the new table.
Remarks
Avoid using hard-coded passwords in your applications. If a password is required in a procedure, request the password from the user, store it in a variable, and then use the variable in your code.
Avoid using the built-in system administrator (sa) logon account. Instead, make system administrators members of the sysadmin fixed server role, and have them use their own accounts to log on. Use sa only when there is no other way to log on. To prevent unauthorized access through the sa logon account, you should assign that account a strong, unique password.
When possible, use Windows Authentication (also referred to as a trusted connection), which uses a Windows user account to connect to SQL Server. When a user connects through a Windows user account, SQL Server uses information in the Windows operating system to validate the account name and password. Before you can use Windows Authentication, a server administrator must configure SQL Server to use this mode of authentication. If Windows Authentication is not available, avoid saving users' logon information. It is more secure for users to enter their logon information each time they log on.