Bookmark.InsertDatabase(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) Метод

Определение

Извлекает данные из источника данных (например, из отдельного документа Microsoft Office Word, листа Microsoft Office Excel или базы данных Microsoft Access) и вставляет данные в виде таблицы на место элемента управления 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);

Параметры

Format
Object

Формат, указанный в поле Форматы диалогового окна Автоформат таблицы. Может принимать значение любой из констант WdTableFormat. По умолчанию для ячеек таблицы устанавливается граница.

Style
Object

К таблице применяются атрибуты автоформата, указанные в параметре Format. Используйте сумму любого сочетания указанных ниже значений. [1|1] Значение [1|2] Смысл [2|1] 0 (ноль) [2|2] Отсутствует [3|1] 1 [3|2] Границы [4|1] 2 [4|2] Заливка [5|1] 4 [5|2] Шрифт [6|1] 8 [6|2] Цвет [7|1] 16 [7|2] Автоподбор [8|1] 32 [8|2] Строки заголовка [9|1] 64 [9|2] Последняя строка [10|1] 128 [10|2] Первый столбец [11|1] 256 [11|2] Последний столбец

LinkToSource
Object

Значение true используется для установления связи между новой таблицей и источником данных.

Connection
Object

Диапазон, в котором будет выполняться запрос, указанный в SQLStatement. Способ задания диапазона зависит от способа получения данных. Пример: При загрузке данных через ODBC (Open Database Connectivity) указывается строка подключения.

При загрузке данных из Microsoft Office Excel через DDE (dynamic data exchange) указывается именованный диапазон или значение «Entire Spreadsheet» (вся электронная таблица).

Примечание Технология DDE устарела и не является безопасной. Рекомендуется использовать более безопасные технологии, например OLE.

При загрузке данных из Microsoft Access указывается слово «Table» (таблица) или «Query» (запрос) за которым следует имя таблицы или запроса.

SQLStatement
Object

Необязательная строка запроса, предназначенного для загрузки вставляемого в документ подмножества данных в основном источнике данных.

SQLStatement1
Object

Если строка запросов состоит из более чем 255 знаков, в параметре SQLStatement указывается первая часть строки, а в параметре SQLStatement1 — вторая.

PasswordDocument
Object

Пароль (если есть), необходимый для открытия источника данных. (См. примечания ниже).

PasswordTemplate
Object

Если в качестве источника данных используется документ Microsoft Office Word, в этом аргументе указывается пароль (если есть), необходимый для открытия присоединенного шаблона. (См. примечания ниже).

WritePasswordDocument
Object

Пароль, необходимый для сохранения изменений в документе. (См. примечания ниже).

WritePasswordTemplate
Object

Пароль, необходимый для сохранения изменений в шаблоне. (См. примечания ниже).

DataSource
Object

Путь и имя файла источника данных.

From
Object

Номер первой записи данных в диапазоне вставляемых записей.

To
Object

Номер последней записи данных в диапазоне вставляемых записей.

IncludeFields
Object

Значение true используется для включения имен полей из источника данных в первую строку новой таблицы.

Примеры

В этом примере в элемент управления вставляется электронная таблица Microsoft Excel Bookmark . Значение стиля (191) представляет собой сочетание чисел 1, 2, 4, 8, 16, 32 и 128. В этом примере предполагается, что книга с именем Data.xlsx сохранена в корневую папку каталога C по крайней мере с двумя строками данных на листе.

Этот пример предназначен для настройки на уровне документа.

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

Комментарии

Не используйте жестко запрограммированные пароли в приложениях. Если в процедуре требуется пароль, запросите пароль у пользователя, сохраните его в переменной, а затем используйте переменную в коде.

Избегайте использования встроенной учетной записи входа системного администратора (SA). Вместо этого следует сделать системных администраторов членом предопределенной роли сервера sysadmin и использовать собственные учетные записи для входа в систему. Используйте SA, только если нет других способов входа в систему. Чтобы предотвратить несанкционированный доступ с помощью учетной записи SA, следует назначить этой учетной записи надежный уникальный пароль.

По возможности используйте проверку подлинности Windows (также называемую доверительным соединением), которая использует учетную запись пользователя Windows для подключения к SQL Server. Когда пользователь подключается с помощью учетной записи пользователя Windows, SQL Server использует сведения в операционной системе Windows для проверки имени учетной записи и пароля. Прежде чем использовать проверку подлинности Windows, администратор сервера должен настроить SQL Server для использования этого режима проверки подлинности. Если проверка подлинности Windows недоступна, не сохраняйте сведения о входе пользователей. Более безопасно вводить регистрационные данные при каждом входе в систему.

Необязательные параметры

Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.

Применяется к