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

Bookmark.InsertDatabase - метод

  • Статья

Извлекает данные из источника данных (например, из отдельного документа Microsoft Office Word, листа Microsoft Office Excel или базы данных Microsoft Access) и вставляет данные в виде таблицы на место элемента управления Bookmark.

Пространство имен:  Microsoft.Office.Tools.Word
Сборка:  Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)

Синтаксис

'Декларация
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
)

Параметры

  • Format
    Тип: System.Object%
    Формат, указанные в поле Форматы диалогового окна Автоформат таблицы.Может принимать значение любой из констант WdTableFormat.По умолчанию для ячеек таблицы устанавливается граница.
  • Style
    Тип: System.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
    Тип: 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);
}

Безопасность платформы .NET Framework

См. также

Ссылки

Bookmark Интерфейс

Microsoft.Office.Tools.Word - пространство имен