Свойство DataSessionID

Возвращает идентификатор сеанса, соответствующий локальному сеансу для объекта FormSet, Form или ToolBar.

Если свойство DataSession объекта Form, FormSet или ToolBar установлено равным 1 (сеанс, действующий по умолчанию), возвращается идентификатор сеанса, испо ьзуемого по умолчанию.

Применение

Form, FormSet, _SCREEN, ToolBar

Синтаксис

Object.DataSessionID

Комментарии

Доступно только для чтения на этапе разработки и для чтения-записи на этапе в полнения. Доступно только в том случае, если свойство DataSession объекта FormSet, Form или ToolBar установлено равным 2 (локальный сеанс).

Используя команду SET DATASESSIONID совместно со свойством DataSessionID, мож о менять сеансы.

Когда вы устанавливаете значение для DataSessionID, оно затрагивает ействующий сеанс для этого объекта и всех объектов, содержащихся в нем. Установка свойства DataSessionID не влияет на объекты, находящиеся вне данного, и на объекты, созданные с помощью функции CREATEOBJECT( ).

Когда изменяется установка свойства DataSessionID, происходит увеличение конт ольного счетчика сеанса, который был принят, и уменьшение контрольного счетчика сеанса, который был заменен. Например, если сеанс был создан в результате уста овки значения свойства DataSession равным 2 (локальный сеанс), то при измене ии установки свойства DataSessionID первоначальный сеанс не освободится: для того сначала нужно освободить объект.

Подробнее об использовании нескольких сеансов обработки данных см. тему Разделение сеансов и главу 19 "Программирование совместного доступа к данным" Руководства разработчика.

Внимание Изменение установки свойства DataSessionID объекта, который содержит элемент управления, привязанные к данным, приведет к тому, что эти элементы управле ия потеряют свои первоначальные источники данных. Старайтесь использовать свойство DataSessionID для объектов, не содержащих элементы управления, привязанные к данным.