Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы справочников

НайтиПоНаименованию

Найти элемент справочника по наименованию.

Синтаксис:

НайтиПоНаименованию(<Наименование>, <Режим>, <ФлагПоиска>)

Англоязычный синоним:

FindByDescr

Параметры:

<Наименование> Строковое выражение с наименованием искомого элемента справочника.
<Режим> Необязательный параметр. Числовое выражение – режим поиска: 1 – поиск внутри установленного подчинения (родителя); 0 – поиск во всем справочнике вне зависимости от родителя. Значение по умолчанию – 1.
<ФлагПоиска> Необязательный параметр. Числовое выражение – флаг поиска: 1 – найти точное соответствие наименования; 0 – найти наименование по первым символам. Значение по умолчанию – 0.

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

Число 1 – если действие выполнено;

Число 0 – если действие не выполнено (элемент не найден).

Описание:

Метод НайтиПоНаименованию выполняет поиск элемента справочника по наименованию, заданному параметром <Наименование> и позиционирует объект справочник на этом элементе.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Спр = СоздатьОбъект("Справочник.Сотрудники");

Спр.ИспользоватьДату(ДатаДок);

// Позиционируем созданный объект Спр по известному наименованию

Спр.НайтиПоНаименованию("Иванов", 1);

Если Спр.Выбран() > 0 Тогда

Оклад=Спр.Оклад;

Подразделение = Спр.Подразделение;

Иначе

Предупреждение("Нет у нас Ивановых!");

КонецЕсли;

См. также: ПолноеНаименование.

Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.