Bookmark.InsertDatabase Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Word

Сборка:: Microsoft.Office.Tools.Word.dll

Важно!

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

Извлекает данные из источника данных (например, из отдельного документа 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);

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)

Параметры

Format: Object

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

Style: Object

LinkToSource: Object

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

Connection: Object

Диапазон, в котором выполняется запрос, заданный параметром SQLStatement. Способ задания диапазона зависит от способа получения данных. Например: при получении данных через Open Database Connectivity (ODBC) укажите строка подключения. При получении данных из Microsoft Office Excel с помощью динамического обмена данными (DDE) укажите именованный диапазон или "Вся электронная таблица". Примечание . Динамический обмен данными (DDE) — это устаревшая технология, которая не является безопасной. По возможности используйте более безопасную альтернативу DDE, например связывание и внедрение объектов (OLE). При получении данных из Microsoft Access укажите слово "Таблица" или "Запрос", за которым следует имя таблицы или запроса.

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 элемент управления . Значение Style (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.

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

Поделиться через