Переводит параметры сеанса в состояние "Не установлено". Если параметр <ОчищаемыеПараметры> опущен или его значение равно Неопределено, то все параметры сеанса, определенные в конфигурации, переводятся в состояние "Не установлено". Иначе состояние "Не установлено" получают только те параметры сеанса, имена которых перечислены в значении параметра <ОчищаемыеПараметры>. Для выполнения метода текущему пользователю информационной базы требуются права на установку каждого параметра сеанса из <ОчищаемыеПараметры>. Если параметр <ОчищаемыеПараметры> не указан, требуются права на установку всех параметров сеанса, определенных в конфигурации.
Синтаксис
Очистить(<ОчищаемыеПараметры>)Примеры платформы
ПараметрыСеанса.Очистить();
ОчищаемыеПараметры = Новый Массив;
ОчищаемыеПараметры.Добавить("ПараметрСеанса1");
ПараметрыСеанса.Очистить(ОчищаемыеПараметры);Полное описание, параметры и ограничения
ПараметрыСеанса.Очистить (SessionParameters.Clear)
ПараметрыСеанса (SessionParameters)
Очистить (Clear)
Доступен, начиная с версии 8.2.
Синтаксис:
Очистить(<ОчищаемыеПараметры>)
Параметры:
<ОчищаемыеПараметры> (необязательный)
Тип: Массив, Неопределено.
Если параметр опущен или имеет значение Неопределено, то все параметры сеанса будут сброшены в "Не установлено".
Если параметр имеет значение типа Массив, то элементами массива должны быть строки, каждая из которых должна содержать имя параметра сеанса. Все перечисленные параметры сеанса получат состояние "Не установлено".
Значение по умолчанию: Неопределено.
Описание:
Переводит параметры сеанса в состояние "Не установлено".
Если параметр <ОчищаемыеПараметры> опущен или его значение равно Неопределено, то все параметры сеанса, определенные в конфигурации, переводятся в состояние "Не установлено". Иначе состояние "Не установлено" получают только те параметры сеанса, имена которых перечислены в значении параметра <ОчищаемыеПараметры>. Для выполнения метода текущему пользователю информационной базы требуются права на установку каждого параметра сеанса из <ОчищаемыеПараметры>. Если параметр <ОчищаемыеПараметры> не указан, требуются права на установку всех параметров сеанса, определенных в конфигурации.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
ПараметрыСеанса.Очистить();
ОчищаемыеПараметры = Новый Массив;
ОчищаемыеПараметры.Добавить("ПараметрСеанса1");
ПараметрыСеанса.Очистить(ОчищаемыеПараметры);
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Перевести один собственный параметр сеанса в состояние не установлен
Явный массив имен не дает очистить все параметры сеанса по умолчанию.
Где и как запускать
Сервер собственной учебной базы; также толстый клиент или внешнее соединение, если это разрешено указанным API.
Подготовка
Только собственная учебная конфигурация. Все указанные имена сначала создайте в Конфигураторе; объекты рабочей базы не заменяйте. Здесь код не запускается.
Создайте свой параметр сеанса УчебнаяОрганизация. Нужны права метода; предварительно изучите собственный обработчик УстановкаПараметровСеанса. Не используйте параметр, от которого зависят ограничения доступа рабочей базы.
&НаСервереБезКонтекста
Процедура ОчиститьУчебныйПараметр()
Имена = Новый Массив;
Имена.Добавить("УчебнаяОрганизация");
ПараметрыСеанса.Очистить(Имена);
Сообщить("Очищено состояние собственного параметра сеанса");
КонецПроцедурыРазбор по шагам
Создайте массив с одним собственным именем.
Передайте его в Очистить.
При следующем обращении наблюдайте штатную установку этого параметра своей конфигурацией.
Как проверить результат
Аргумент не опущен и не равен Неопределено.
Очистка не описывается как присваивание пустой ссылки.
Ожидаемый результат
Только выбранный параметр переводится в состояние не установлен.
На что обратить внимание
Повторное чтение может вызвать обработчик установки и снова заполнить параметр; это не отсутствие всех параметров сеанса навсегда.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.