2 378 документов
← К списку

ХранилищеНастроекДанныхФормЗагрузить

страница

Предусмотрено две одноименных функции: ОбщегоНазначения.ХранилищеНастроекДанныхФормЗагрузить для вызова с сервера ОбщегоНазначенияВызовСервера.ХранилищеНастроекДанныхФормЗагрузить для вызова с клиента

1. Для вызова с сервера

Загружает настройку из хранилища настроек данных форм, как метод платформы Загрузить, объектов СтандартноеХранилищеНастроекМенеджер или ХранилищеНастроекМенеджер.<Имя хранилища>, но с поддержкой длины ключа настроек более 128 символов путем хеширования части, которая превышает 96 символов. Кроме того, возвращает указанное значение по умолчанию, если настройки не существуют. Если нет права СохранениеДанныхПользователя, возвращается значение по умолчанию без ошибки. В возвращаемом значении очищаются ссылки на несуществующий объект в базе данных, а именно

  • возвращаемая ссылка заменяется на указанное значение по умолчанию;
  • из данных типа Массив ссылки удаляются;
  • у данных типа Структура и Соответствие ключ не меняется, а значение устанавливается Неопределено;
  • анализ значений в данных типа Массив, Структура, Соответствие выполняется рекурсивно.

Синтаксис

Функция ХранилищеНастроекДанныхФормЗагрузить(КлючОбъекта, КлючНастроек, ЗначениеПоУмолчанию = Неопределено, 
		ОписаниеНастроек = Неопределено, ИмяПользователя = Неопределено) Экспорт

Параметры

  • КлючОбъекта — Строка - см. синтакс-помощник платформы.
  • КлючНастроек — Строка - см. синтакс-помощник платформы.
  • ЗначениеПоУмолчанию — Произвольный - значение, которое возвращается, если настройки не существуют. Если не указано, возвращается значение Неопределено.
  • ОписаниеНастроек — ОписаниеНастроек - см. синтакс-помощник платформы.
  • ИмяПользователя — Строка - см. синтакс-помощник платформы.

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

Произвольный - см. синтакс-помощник платформы.

Пример вызова

Результат = ОбщегоНазначения.ХранилищеНастроекДанныхФормЗагрузить(КлючОбъекта, КлючНастроек, ЗначениеПоУмолчанию, ОписаниеНастроек, ИмяПользователя)

Доступность

Сервер, Толстый клиент, Внешнее соединение

2. Для вызова с клиента и сервера

Загружает настройку из хранилища настроек данных форм, как метод платформы Загрузить, объектов СтандартноеХранилищеНастроекМенеджер или ХранилищеНастроекМенеджер.<Имя хранилища>, но с поддержкой длины ключа настроек более 128 символов путем хеширования части, которая превышает 96 символов. Кроме того, возвращает указанное значение по умолчанию, если настройки не существуют. Если нет права СохранениеДанныхПользователя, возвращается значение по умолчанию без ошибки. В возвращаемом значении очищаются ссылки на несуществующий объект в базе данных, а именно

  • возвращаемая ссылка заменяется на указанное значение по умолчанию;
  • из данных типа Массив ссылки удаляются;
  • у данных типа Структура и Соответствие ключ не меняется, а значение устанавливается Неопределено;
  • анализ значений в данных типа Массив, Структура, Соответствие выполняется рекурсивно. См. ОбщегоНазначения.ХранилищеНастроекДанныхФормЗагрузить

Синтаксис

Функция ХранилищеНастроекДанныхФормЗагрузить(КлючОбъекта, КлючНастроек, ЗначениеПоУмолчанию = Неопределено,
		ОписаниеНастроек = Неопределено,
		ИмяПользователя = Неопределено) Экспорт

Параметры

  • КлючОбъекта — Строка - см. синтакс-помощник платформы.
  • КлючНастроек — Строка - см. синтакс-помощник платформы.
  • ЗначениеПоУмолчанию — Произвольный - значение, которое возвращается, если настройки не существуют. Если не указано, возвращается значение Неопределено.
  • ОписаниеНастроек — ОписаниеНастроек - см. синтакс-помощник платформы.
  • ИмяПользователя — Строка - см. синтакс-помощник платформы.

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

Произвольный - см. синтакс-помощник платформы.

Пример вызова

Результат = ОбщегоНазначенияВызовСервера.ХранилищеНастроекДанныхФормЗагрузить(КлючОбъекта, КлючНастроек, ЗначениеПоУмолчанию, ОписаниеНастроек, ИмяПользователя)

Доступность

Сервер, Вызов сервера