Документация

README.md

@@ -27,6 +27,7 @@
   * <a href="#entity-read">Чтение и поиск объектов</a>
     * <a href="#entity-complex-find">Поиск сущностей со сложными отборами</a>
     * <a href="#entity-sort">Сортировка результатов</a>
+    * <a href="#entity-limit">Пропуск и смещение</a>
   * <a href="#entity-delete">Удаление сущностей</a>
   * <a href="#entity-active-record">Активная запись</a>
   * <a href="#entity-repository">Работа через ХранилищеСущностей</a>
@@ -285,6 +286,28 @@
 
 ```
 
+<a id="#entity-limit">
+
+### Пропуск и смещение
+
+```bsl
+
+// Привычный Выбрать Первые Х реализуется через ОпцииПоиска
+ОпцииПоиска = Новый ОпцииПоиска()
+  .Первые(10);
+
+ПервыеДесятьФизлиц = МенеджерСущностей.Получить(Тип("ФизическоеЛицо"), ОпцииПоиска);
+
+// При желании можно использовать поиск со смещением, например, для реализации постраничной загрузки.
+// Всегда указывайте правила сортировки для повторяемости результата.
+ОпцииПоиска = Новый ОпцииПоиска()
+  .Первые(10)
+  .Смещение(50)
+  .СортироватьПо("Идентификатор", НаправлениеСортировки.ПоВозрастанию);
+
+ШестойДесятокФизлиц = МенеджерСущностей.Получить(Тип("ФизическоеЛицо"), ОпцииПоиска);
+```
+
 <a id="entity-delete" />
 
 ## Удаление сущностей

docs/ОпцииПоиска.md

@@ -60,3 +60,53 @@
 Функция СортироватьПо(ИмяПоля, НаправлениеСортировки = Неопределено) 
 ```
 
+### ВыбираютсяПервые
+
+```bsl
+// Получить количество элементов, которые необходимо выбрать.
+//
+// Возвращаемое значение:
+//   Число - Количество элементов.
+//
+Функция ВыбираютсяПервые() 
+```
+
+### Первые
+
+```bsl
+// Выбрать первые n элементов.
+//
+// Параметры:
+//   КоличествоЭлементов - Число - Количество элементов.
+//
+// Возвращаемое значение:
+//   ОпцииПоиска - Текущий объект.
+//
+Функция Первые(КоличествоЭлементов) 
+```
+
+### ВыбираетсяСоСмещением
+
+```bsl
+// Получить количество элементов, которые необходимо пропустить.
+//
+// Возвращаемое значение:
+//   Число - Количество элементов.
+//
+Функция ВыбираетсяСоСмещением() 
+```
+
+### Смещение
+
+```bsl
+// Сместить выборку на n элементов.
+//
+// Параметры:
+//   КоличествоЭлементов - Число - Количество элементов.
+//
+// Возвращаемое значение:
+//   ОпцииПоиска - Текущий объект.
+//
+Функция Смещение(КоличествоЭлементов) 
+```
+

src/Классы/ОпцииПоиска.os

@@ -58,21 +58,47 @@
 
 КонецФункции
 
+// Получить количество элементов, которые необходимо выбрать.
+//
+// Возвращаемое значение:
+//   Число - Количество элементов.
+//
 Функция ВыбираютсяПервые() Экспорт
 	Возврат Первые;
 КонецФункции
 
+// Выбрать первые n элементов.
+//
+// Параметры:
+//   КоличествоЭлементов - Число - Количество элементов.
+//
+// Возвращаемое значение:
+//   ОпцииПоиска - Текущий объект.
+//
 Функция Первые(КоличествоЭлементов) Экспорт
 
 	Первые = КоличествоЭлементов;
 
 	Возврат ЭтотОбъект;
 КонецФункции
 
+// Получить количество элементов, которые необходимо пропустить.
+//
+// Возвращаемое значение:
+//   Число - Количество элементов.
+//
 Функция ВыбираетсяСоСмещением() Экспорт
 	Возврат Смещение;
 КонецФункции
 
+// Сместить выборку на n элементов.
+//
+// Параметры:
+//   КоличествоЭлементов - Число - Количество элементов.
+//
+// Возвращаемое значение:
+//   ОпцииПоиска - Текущий объект.
+//
 Функция Смещение(КоличествоЭлементов) Экспорт
 
 	Смещение = КоличествоЭлементов;