0

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

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

Синтаксис

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

Описание

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

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

Доступность

Сервер, толстый клиент, внешнее соединение, мобильное приложение(сервер).

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

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

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

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

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

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

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

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