Выполняет поиск всех строк в коллекции строк дерева значений, соответствующих заданному отбору
Синтаксис
Метод НайтиСтроки() имеет следующий синтаксис:
Массив НайтиСтроки(ПараметрыОтбора, [ВключатьПодчиненные])
А также альтернативный англоязычный синтаксис:
Array FindRows(Filter, [IncNested])
Параметры
Описание параметров метода НайтиСтроки():
| Имя параметра* | Тип | Описание |
|---|---|---|
| ПараметрыОтбора | Структура | Задает отбор (условия поиска): ключ структуры определяет имя колонки дерева значений, по которой будет осуществляться поиск, а значение структуры — искомое значение. Сравнение ведется на равенство значений |
| ВключатьПодчиненные | Булево | Признак включения в поиск подчиненных строк (если таковые имеются).
Значение по умолчанию: Ложь. |
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
Массив — Массив ссылок на строки дерева значений, удовлетворяющих заданному отбору.
Описание
Метод НайтиСтроки() осуществляет поиск всех строк в коллекции строк дерева значений, соответствующих заданному условию поиска.
Внимание! Метод эффективно использовать для выборки неуникальных значений. Для поиска уникальных значений лучше воспользоваться методом ДеревоЗначений.Строки.Найти()
Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | Сервер, Клиент, Внешнее соединение |
| 8.2 | Сервер, Толстый клиент, Внешнее соединение |
| 8.3 | Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение |
Пример использования
Пример кода с использованием метода НайтиСтроки():
//создание нового дерева значений ДеревоЗначений = Новый ДеревоЗначений; //добавим колонки ДеревоЗначений.Колонки.Добавить("Наименование"); ДеревоЗначений.Колонки.Добавить("КодТовара"); // //заполнение дерева // //определение параметров поиска ПараметрыПоиска = Новый Структура; ПараметрыПоиска.Вставить("Наименование", "Стол деревянный"); //поиск строк мНайдСтроки = ДеревоЗначений.Строки.НайтиСтроки(ПараметрыПоиска, Истина); Если мНайдСтроки.Количество() = 0 Тогда Сообщить("Ничего не найдено!", СтатусСообщения.Важное); КонецЕсли;