AppendBlankByKeySet method (IZbQueryInfo)

Добавляет пустые записи по заданному набору ключей (идентификаторов объектов).

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

IZbQueryInfo

Синтаксис:

Visual Basic:

Function AppendBlankByKeySet(KeySet, OptionsOrCount As Long) As Boolean

KeySet, OptionsOrCount - задают набор ключей одним из возможных вариантов (см. таблицу).

KeySet

OptionsOrCount

Значение

<имя_файла>

zbkoTextFile

Набор ключей задается в текстовом файле. Путь к файлу передается в параметре KeySet в виде строки. Каждая строка файла содержит целое число - ключ объекта.

<имя_файла>

zbkoBinaryFile

Набор ключей задается в двоичном файле, путь к которому указан в параметре KeySet. Первые 4 байта этого файла - число ключей, остальные данные - массив ключей по 4 байта на каждый ключ.

значение из набора zbKeyFilterType

zbkoKeyFilter

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

строка с разделителем (ASCII 10)

zbkoStrings

Набор ключей перечислен в одной строке. В качестве разделителя используется символ ASCII 10.

массив строк

(пусто)

Набор ключей задается массивом (safearray) строк.

массив целых чисел

(пусто)

Набор ключей задается массивом (safearray) целых чисел.

указатель на целое число

число элементов

Набор ключей задается массивом целых чисел, при этом KeySet указывает на первый элемент массива, а OptionsOrCount содержит число элементов массива.

Описание:

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

В случае успешного добавления записи метод вернет True, иначе False. Свойства LastError и LastErrorString базы данных содержат информацию об ошибке.