Производит выборку записей по заданному набору ключей.
Visual Basic:
Function SelectByKeySet(KeySet, OptionsOrCount As Long, Fields, [Count]) As IZbDataset
KeySet, OptionsOrCount - задают набор ключей; Fields, Count - задают список полей, которые должны войти в ответ
Метод производит выборку данных по заданному набору ключей и заданному набору полей.
В случае успешного добавления записи метод вернет True, иначе False. Свойства LastError и LastErrorString текущей базы содержат информацию об ошибке.
Параметры KeySet и OptionsOrCount задают набор ключей одним из возможных способов:
KeySet
OptionsOrCount
Значение
<имя_файла>
zbkoTextFile
Набор ключей задается в текстовом файле. Путь к файлу передается в параметре KeySet в виде строки. Каждая строка файла содержит целое число - ключ объекта.
<имя_файла>
zbkoBinaryFile
Набор ключей задается в двоичном файле, путь к которому указан в параметре KeySet в виде строки. Первые 4 байта этого файла - число ключей, остальные данные - массив ключей по 4 байта на каждый ключ.
Объект ElementKeys Не используется, д. б. 0 Набор ключей передается в виде коллекции ElementKeys. Объект IZEnumElements Не используется, д. б. 0 Набор ключей передается в виде итератора IZEnumElements. строка с разделителем (ASCII 10)
zbkoStrings
Набор ключей перечислен в одной строке. В качестве разделителя используется символ ASCII 10.
массив строк
Не используется, д. б. 0
Набор ключей задается массивом (safearray) строк.
массив целых чисел
Не используется, д. б. 0
Набор ключей задается массивом (safearray) целых чисел.
указатель на целое число
число элементов
Набор ключей задается массивом целых чисел, при этом KeySet указывает на первый элемент массива, а OptionsOrCount содержит число элементов массива.
Параметры Fields и Count - задают список полей, которые должны войти в ответ. Если Fields пусто, то в ответ попадут все поля запроса, иначе список Fields может быть задан как:
Строка, перечисляющая имена поля, разделенные символом ASCII 10.
Массив строк (safearray), содержащий имена полей.
Массив целых чисел (safearray), содержащий индексы полей, считая от нуля.
Указатель на целое число, являющееся первым элементом массива индексов полей. В этом случае в параметре Count передается число элементов этого массива.