0

Функция ЗначениеВСтроку()

Возвращает значение в строковом системном виде

Синтаксис

Функция ЗначениеВСтроку() имеет следующий синтаксис:

строка ЗначениеВСтроку(Объект)

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

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 Тогда
        Сообщить(Объект);
    КонецЕсли;
Исключение
    Сообщить("Объект не найден!");
КонецПопытки;

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

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