Bookmark.InsertDatabase Метод (2007 System)
Обновлен: Ноябрь 2007
Извлекает данные из источника данных (например, из отдельного документа Microsoft Office Word, листа Microsoft Office Excel или базы данных Microsoft Access) и вставляет данные в виде таблицы на место элемента управления Bookmark.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)
Синтаксис
'Декларация
Public 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 _
)
'Применение
Dim instance As Bookmark
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)
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
)
Параметры
- Format
Тип: System.Object%
Формат, указанные в поле Форматы диалогового окна Автоформат таблицы. Может принимать значение любой из констант WdTableFormat. По умолчанию для ячеек таблицы устанавливается граница.
- Style
Тип: System.Object%
К таблице применяются атрибуты автоформата, указанные в параметре Format. Используйте сумму любого сочетания указанных ниже значений.Значение
Значение
0 (ноль)
Отсутствуют
1
Границы
2
Заливка
4
Шрифт
8
Цвет
16
Автоподбор
32
Строки заголовка
64
Последняя строка
128
Первый столбец
256
Последний столбец
- LinkToSource
Тип: System.Object%
Значение true используется для установления связи между новой таблицей и источником данных.
- Connection
Тип: System.Object%
Диапазон, в котором будет выполняться запрос, указанный в параметре SQLStatement. Способ задания диапазона зависит от способа получения данных. Пример.При загрузке данных через ODBC (Open Database Connectivity) указывается строка подключения.
При загрузке данных из Microsoft Office Excel через DDE (dynamic data exchange) указывается именованный диапазон или значение "Entire Spreadsheet" (вся электронная таблица).
Примечание. Технология DDE устарела и не является безопасной. Рекомендуется использовать более безопасные технологии, например OLE.
При загрузке данных из Microsoft Access указывается слово "Table" (таблица) или "Query" (запрос) за которым следует имя таблицы или запроса.
- SQLStatement
Тип: System.Object%
Необязательная строка запроса, предназначенного для загрузки вставляемого в документ подмножества данных в основном источнике данных.
- SQLStatement1
Тип: System.Object%
Если строка запросов состоит из более, чем 255 знаков, в параметре SQLStatement указывается первая часть строки, а в параметре SQLStatement1 — вторая.
- PasswordDocument
Тип: System.Object%
Пароль (если есть), необходимый для открытия источника данных. (См. примечания ниже).
- PasswordTemplate
Тип: System.Object%
Если в качестве источника данных используется документ Microsoft Office Word, в этом аргументе указывается пароль (если есть), необходимый для открытия присоединенного шаблона. (См. примечания ниже).
- WritePasswordDocument
Тип: System.Object%
Пароль, необходимый для сохранения изменений в документе. (См. примечания ниже).
- WritePasswordTemplate
Тип: System.Object%
Пароль, необходимый для сохранения изменений в шаблоне. (См. примечания ниже).
- DataSource
Тип: System.Object%
Путь и имя файла источника данных.
- From
Тип: System.Object%
Номер первой записи данных в диапазоне вставляемых записей.
- To
Тип: System.Object%
Номер последней записи данных в диапазоне вставляемых записей.
- IncludeFields
Тип: System.Object%
Значение true используется для включения имен полей из источника данных в первую строку новой таблицы.
Заметки
Следует избегать использования в приложениях жестко заданных паролей. Если в процедуре необходим пароль, запросите его у пользователя, сохраните в переменной и затем используйте эту переменную в программном коде.
Следует избегать использования встроенной учетной записи системного администратора (sa). Вместо использования этой учетной записи сделайте системных администраторов членами фиксированной серверной роли sysadmin, чтобы они использовали для входа в систему собственные учетные записи. Используйте учетную запись sa только в тех случаях, когда другого способа входа в систему не существует. Чтобы предотвратить несанкционированный доступ с использованием учетной записи sa, защитите ее надежным уникальным паролем.
По возможности используйте проверку подлинности Windows (также известную как доверительное соединение), при которой для подключения к серверу SQL Server используется учетная запись пользователя Windows. Когда пользователь подключается с использованием учетной записи пользователя Windows, сервер SQL Server использует для проверки имени пользователя и пароля данные, хранящиеся в операционной системе Windows. Перед использованием проверки подлинности Windows администратор сервера должен настроить сервер SQL Server на использование этого режима. Если проверку подлинности Windows использовать нельзя, постарайтесь не сохранять данные пользователей для входа в систему. Гораздо безопаснее, если пользователи будут вводить свои данные каждый раз при входе в систему.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.
Примеры
В данном примере в элемент управления Bookmark вставляется электронная таблица Microsoft Excel. Значение параметра Style (191) представляет сумму чисел 1, 2, 4, 8, 16, 32 и 128. В данном примере предполагается, что книга Data.xls хранится в корневом каталоге диска C и имеет по крайней мере две строки данных на листе.
В этом примере демонстрируется настройка уровня документа.
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.xls")
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.xls";
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);
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.