0

ДеревоЗначений.Строки
Метод Найти()

Осуществляет поиск строки в коллекции строк дерева значений по значению

Синтаксис

Метод Найти() имеет следующий синтаксис:

СтрокаДереваЗначений Найти(Значение, [Колонки=""], [ВключатьПодчиненные])

А также альтернативный англоязычный синтаксис:

ValueTreeString Find(Value, [Columns=""], [IncNested])

Параметры

Описание параметров метода Найти():

Имя параметра* Тип Описание
Значение Произвольный Искомое значение.
Колонки Строка Список имен колонок, разделенных запятыми, по которым производится поиск.

Значение по умолчанию: пустая строка.

ВключатьПодчиненные Булево Признак включения в поиск подчиненных строк.

Значение по умолчанию: Ложь

*Жирным шрифтом выделены обязательные параметры

Возвращаемое значение

СтрокаДереваЗначений — первая найденная строка, в которой содержится искомое значение
Неопределено — строка не найдена

Описание

Метод Найти() осуществляет поиск строки в коллекции строк дерева значений, содержащей искомое значение. По умолчанию, поиск осуществляется по всем колонкам дерева значений. Однако, если указать параметр Колонки, поиск будет осуществляется только в указанной колонке\колонках.

Внимание! Метод эффективно использовать для поиска уникальных значений.
Внимание!! Метод находит только первую строку с указанным значением. Чтобы найти все строки, воспользуйтесь методом ДеревоЗначений.Строки.НайтиСтроки()

Доступность

Версия Поддержка
8.1 Сервер, Клиент, Внешнее соединение
8.2 Сервер, Толстый клиент, Внешнее соединение
8.3 Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение

Пример использования

Пример кода с использованием метода Найти():

//ДеревоЗначений - табличное поле на форме
//добавим корневую строку
КорневаяСтрока = ДеревоЗначений.Строки.Добавить();
КорневаяСтрока.Наименование = "МЕБЕЛЬ";

//добавим подчиненные строки для корневой
НоваяСтрока = КорневаяСтрока.Строки.Добавить();
НоваяСтрока.Наименование = "Стол деревянный";
НоваяСтрока.КодТовара = "СТО_Д_1";

НоваяСтрока = КорневаяСтрока.Строки.Добавить();
НоваяСтрока.Наименование = "Стул деревянный";
НоваяСтрока.КодТовара = "СТУ_Д_1";

НайдСтрока = ДеревоЗначений.Строки.Найти("СТУ_Д_1", "КодТовара", Истина);
Если НЕ НайдСтрока = Неопределено Тогда
	//установим строку на форме текущей
	ЭлементыФормы.ДеревоЗначений.ТекущаяСтрока = НайдСтрока;
КонецЕсли;

Читайте также:

  1. Дерево значений 1с. Описание и примеры использования

Поделиться страницей в соц.сетях

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *