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