Возвращает значение в строковом системном виде
Синтаксис
Функция ЗначениеВСтроку() имеет следующий синтаксис:
строка ЗначениеВСтроку(Объект)
А также альтернативный англоязычный синтаксис:
string ValueToString(Object)
Параметры
Описание параметров функции ЗначениеВСтроку():
| Имя параметра | Тип | Описание |
|---|---|---|
| Объект | Произвольный | значение примитивного или агрегатного типа данных, которое необходимо преобразовать. Также можно указывать значения типа СписокЗначений и ТаблицаЗначений |
| Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
Строка
Описание
Функция ЗначениеВСтроку() преобразует значения большинства типов к строковому системному виду:
//Число: ЗначениеВСтроку(1) //Результат: // {"Число","1"} //Строка: ЗначениеВСтроку("2") //Результат: // {"Строка","2"} //Дата: ЗначениеВСтроку('01.01.2021') //Результат: // {"Дата","20210101"} //Список значений сз = СоздатьОбъект("СписокЗначений"); сз.ДобавитьЗначение(1); сз.ДобавитьЗначение("2"); Сообщить(ЗначениеВСтроку(сз)); //Результат: // {"СписокЗначений",{{{"Число","1"},"","0"},{{"Строка","2"},"","0"}}} //Таблица значений: тз = СоздатьОбъект("ТаблицаЗначений"); тз.НоваяКолонка("Код", "Число", 10); тз.НоваяКолонка("Наименование", "Строка", 100); Сообщить(ЗначениеВСтроку(тз)); //Результат: // {"ТаблицаЗначений","2",{"0","","0","0","0","","2",{{"Код","Код","1","0","0",{"Число","0"},"","2",{}}, // {"Наименование","Наименование","1","0","1",{"Строка",""},"","0",{}}}}} //Ссылка на справочник: Сообщить(ЗначениеВСтроку(Ссылка)); //Результат: // {"Справочник","Номенклатура","00006"} //Ссылка на документ: Сообщить(ЗначениеВСтроку(СсылкаДок)); //Результат: // {"Документ","Поставщик","0000000003","29.07.2021"}
Как видите, в состав системного представления значения включаются следующие легко узнаваемые составные части:
- тип объекта
- строковый идентификатор для объектов агрегатного типа
- код для справочников \ номер и дата для документов
Полученное строковое значение годится для использования в рамках одной конфигурации (например, для хранения нескольких значений расшифровки в ячейках отчетов или для передачи данных в идентичную информационную базу). Для обратного преобразования используется функция ЗначениеИзСтроки().
Пример использования
Пример кода с использованием функции ЗначениеВСтроку():
СсылкаСтр = ЗначениеВСтроку(Ссылка); // //... // Объект = ЗначениеИзСтроки(СсылкаСтр); Попытка Если Объект.Выбран() = 1 Тогда Сообщить(Объект); КонецЕсли; Исключение Сообщить("Объект не найден!"); КонецПопытки;