Admin: 1 revision imported

2021-02-07T06:43:19Z

1 revision imported

Admin at 10:25, 17 September 2019

2019-09-17T10:25:41Z

New page

{{infobox function
|name=Load
|object=[[Объект базы данных]]
|caption=Поиск и загрузка объекта
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку, число, ошибка в фильтрах
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Функция производит поиск и загрузку указанного количества объектов из базы данных в список значений. Объекты идентифицируются с помощью фильтров. Каждый объект, попавший в список, будет загружен. При поиске объектов используется порядок сортировки, заданный функцией [[DB.UseOrder|UseOrder]] и ограничение, заданное функцией [[DB.UseBorders|UseBorders]]. При загрузке объекта, работают правила, заданные функцией [[DB.UseOption|UseOption]]. Функцию удобно использовать вместо [[DB.Select|Select]] для небольшого объема данных, так как загрузка происходит быстрее, однако, нужно понимать, что если объем данных большой, функция может явиться причиной переполнения памяти системы, тогда как функция ''Select'' создает выборку, которая гарантированно не переполнит память.

== Синтаксис ==
<code>
{{Grey|DB.}}'''Load'''({{Optional|<Максимальное количество объектов (INT)>{{Default|{{Eq}}0}},<Стандарные фильтры>...}}):''<Найденные объекты (LIST)>''
</code>

==== Аргументы ====
* <code>''<Максимальное количество объектов (INT)>''</code> - {{Optional}} Задает максимальное количество объектов для загрузки (т.е., будут загружены только указанное количество объектов, попавших под фильтр, остальные будут игнорированы). По умолчанию ''0'' -- не ограничивать количество объектов.
* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры позиционирования описаны в статье [[Стандартные фильтры]].

==== Возвращаемое значение ====
Возвращается список, заполненный найденными объектами. Если ни одного объекта не найдено, будет возвращен пустой список.

== Примеры ==
<pre>
//Поиск документов Реализация по реквизиту aEl.Идентификатор с датой, совпадающей с датой документа aEl, при этом документ не должен совпадать с документом aEl
// и их загрузка в список aList
аДок:=Doc.Реализация;
aList:=аДок.Load("<DocDate,>=DocDate,Идентификатор,<>@ELEMENT",BegOfDay(aEl.DocDate+1),BegOfDay(aEl.DocDate),aEl.Идентификатор,aEl);

//Тот же пример, но с использованием сложного режима фильтров
аДок:=Doc.Реализация;
aList:=аДок.Load(0,"~(BegOfDay(DocDate)=BegOfDay(aEl.DocDate))And(Идентификатор=aEl.Идентификатор)And(aEl<>@ELEMENT)");
</pre>

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)

DB.Load - Revision history

Admin: 1 revision imported

Admin at 10:25, 17 September 2019